docs: add and fix brand/template resource documentation

pranav-okta · claude · pranav-okta · commit 024d05e1125f · 2026-08-06T11:50:06.000+05:30
- Add missing docs for okta_brands_templates_email_customization resource - Add missing example for okta_brands_templates_email_customization - Fix okta_template_sms: correct template/type to Optional, replace nested block translations with Map of String - Fix okta_email_template_settings: correct recipients to Optional 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/docs/resources/brands_templates_email_customization.md b/docs/resources/brands_templates_email_customization.md
@@ -0,0 +1,51 @@
+---
+page_title: "Resource: okta_brands_templates_email_customization"
+description: |-
+  These endpoints allow you to programmatically manage email customizations.
+---
+
+# Resource: okta_brands_templates_email_customization
+
+These endpoints allow you to programmatically manage email customizations.
+
+## Example Usage
+
+```terraform
+resource "okta_brands_templates_email_customization" "example" {
+  brand_id      = "<brand_id>"
+  template_name = "ForgotPassword"
+  language      = "en"
+  subject       = "Forgot Password"
+  body          = "<html><body>Reset your password here: $${resetPasswordLink}</body></html>"
+  is_default    = true
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `body` (String) The HTML body of the email.
+- `brand_id` (String) The ID of the brand
+- `language` (String) The language specified as an [IETF BCP 47 language tag](https://datatracker.ietf.org/doc/html/rfc5646).
+- `subject` (String) The email subject.
+- `template_name` (String) The name of the email template
+
+### Optional
+
+- `is_default` (Boolean) Whether this is the default customization for the email template.
+
+### Read-Only
+
+- `created` (String) The UTC time at which this email customization was created.
+- `id` (String) The unique identifier for the resource.
+- `last_updated` (String) The UTC time at which this email customization was last updated.
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+terraform import okta_brands_templates_email_customization.example <brand_id>/<template_name>/<id>
+```
diff --git a/docs/resources/email_template_settings.md b/docs/resources/email_template_settings.md
@@ -24,9 +24,12 @@ resource "okta_email_template_settings" "example" {
 ### Required
 
 - `brand_id` (String) The ID of the brand.
-- `recipients` (String) The recipients the emails of this template will be sent to - Valid values: `ALL_USERS`, `ADMINS_ONLY`, `NO_USERS`
 - `template_name` (String) Email template name - Example values: `AccountLockout`,`ADForgotPassword`,`ADForgotPasswordDenied`,`ADSelfServiceUnlock`,`ADUserActivation`,`AuthenticatorEnrolled`,`AuthenticatorReset`,`ChangeEmailConfirmation`,`EmailChallenge`,`EmailChangeConfirmation`,`EmailFactorVerification`,`ForgotPassword`,`ForgotPasswordDenied`,`IGAReviewerEndNotification`,`IGAReviewerNotification`,`IGAReviewerPendingNotification`,`IGAReviewerReassigned`,`LDAPForgotPassword`,`LDAPForgotPasswordDenied`,`LDAPSelfServiceUnlock`,`LDAPUserActivation`,`MyAccountChangeConfirmation`,`NewSignOnNotification`,`OktaVerifyActivation`,`PasswordChanged`,`PasswordResetByAdmin`,`PendingEmailChange`,`RegistrationActivation`,`RegistrationEmailVerification`,`SelfServiceUnlock`,`SelfServiceUnlockOnUnlockedAccount`,`UserActivation`
 
+### Optional
+
+- `recipients` (String) The recipients the emails of this template will be sent to - Valid values: `ALL_USERS`, `ADMINS_ONLY`, `NO_USERS`
+
 ### Read-Only
 
 - `id` (String) The ID of the resource. This is a compound ID of the brand ID and the template name.
diff --git a/docs/resources/template_sms.md b/docs/resources/template_sms.md
@@ -14,46 +14,33 @@ Creates an Okta SMS Template. This resource allows you to create and configure a
 resource "okta_template_sms" "example" {
   type     = "SMS_VERIFY_CODE"
   template = "Your $${org.name} code is: $${code}"
-  translations {
-    language = "en"
-    template = "Your $${org.name} code is: $${code}"
-  }
-
-  translations {
-    language = "es"
-    template = "Tu código de $${org.name} es: $${code}."
+  translations = {
+    en = "Your $${org.name} code is: $${code}"
+    es = "Tu código de $${org.name} es: $${code}."
   }
 }
 ```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
-### Required
-
-- `template` (String) SMS default template
-- `type` (String) SMS template type
-
 ### Optional
 
-- `translations` (Block Set) Set of translations for a particular template. (see [below for nested schema](#nestedblock--translations))
+- `name` (String) Human-readable name of the Template
+- `template` (String) Text of the Template, including any macros
+- `translations` (Map of String) Template translations are optionally provided when you want to localize the SMS messages. Keys are IETF BCP 47 language tags, values are the translated template text.
+- `type` (String) Type of the Template
 
 ### Read-Only
 
-- `id` (String) The ID of this resource.
-
-<a id="nestedblock--translations"></a>
-### Nested Schema for `translations`
-
-Required:
-
-- `language` (String) The language to map the template to.
-- `template` (String) The SMS message.
+- `created` (String) Created
+- `id` (String) The unique identifier for the resource.
+- `last_updated` (String) LastUpdated
 
 ## Import
 
 Import is supported using the following syntax:
 
 ```shell
-terraform import okta_template_sms.example <template_type>
+terraform import okta_template_sms.example <id>
 ```
diff --git a/examples/resources/okta_brands_templates_email_customization/resource.tf b/examples/resources/okta_brands_templates_email_customization/resource.tf
@@ -0,0 +1,8 @@
+resource "okta_brands_templates_email_customization" "example" {
+  brand_id      = "<brand_id>"
+  template_name = "ForgotPassword"
+  language      = "en"
+  subject       = "Forgot Password"
+  body          = "<html><body>Reset your password here: $${resetPasswordLink}</body></html>"
+  is_default    = true
+}
