telnyx 5.168.0 → 5.170.0

data/lib/telnyx/models/email_message_batch_params.rb

@@ -16,8 +16,13 @@ module Telnyx
       required :messages, -> { Telnyx::Internal::Type::ArrayOf[Telnyx::EmailMessageBatchParams::Message] }
 
       # @!attribute sandbox_mode
-      #   Applies sandbox mode to all messages in the batch. Overrides any per-message
-      #   sandbox_mode in the messages array.
+      #   Applies sandbox mode to all messages in the batch and overrides any per-message
+      #   `sandbox_mode` value — each message's effective `sandbox_mode` is exactly this
+      #   envelope value. Reserved recipients at `test.telnyx.com` produce the
+      #   deterministic event chains documented on CreateEmailRequest.sandbox_mode; no
+      #   batch item is injected into the MTA or outbound Kafka path. Sandbox batch items
+      #   are non-billable, consume no daily-send-limit quota, and feed no
+      #   delivery-reputation signals.
       #
       #   @return [Boolean, nil]
       optional :sandbox_mode, Telnyx::Internal::Type::Boolean
@@ -33,7 +38,7 @@ module Telnyx
       #
       #   @param messages [Array<Telnyx::Models::EmailMessageBatchParams::Message>] Array of email messages to send. Up to 1,000 messages per batch request. Each me
       #
-      #   @param sandbox_mode [Boolean] Applies sandbox mode to all messages in the batch. Overrides any per-message san
+      #   @param sandbox_mode [Boolean] Applies sandbox mode to all messages in the batch and overrides any per-message
       #
       #   @param idempotency_key [String]
       #
@@ -105,7 +110,9 @@ module Telnyx
         optional :inline_css, Telnyx::Internal::Type::Boolean
 
         # @!attribute metadata
-        #   Custom metadata. Write-only; not returned in responses.
+        #   Custom metadata key/value pairs. Stored on the message, returned on message
+        #   responses, and propagated to Email Detail Records. Usable in `filter[metadata]`
+        #   when listing messages.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
@@ -118,15 +125,21 @@ module Telnyx
         optional :reply_to, union: -> { Telnyx::EmailAddressInput }
 
         # @!attribute sandbox_mode
+        #   Per-message sandbox flag. The batch-level `sandbox_mode` envelope value is
+        #   authoritative: it overwrites every message's `sandbox_mode` before processing,
+        #   including the `false` default when the envelope omits the field. A per-item
+        #   `sandbox_mode: true` inside a non-sandbox batch is therefore a real send. Set
+        #   the envelope field to run any batch item in sandbox mode.
         #
         #   @return [Boolean, nil]
         optional :sandbox_mode, Telnyx::Internal::Type::Boolean
 
         # @!attribute scheduled_at
-        #   Future ISO 8601 time to schedule sending. Invalid or past timestamps are
-        #   silently ignored and the email is sent immediately. The legacy alias `send_at`
-        #   is still accepted for backward compatibility; when both are provided,
-        #   `scheduled_at` wins.
+        #   Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected.
+        #   Single sends return HTTP 422; in batch sends the invalid item is reported in the
+        #   207 per-item errors while other items continue. `send_at` remains a deprecated
+        #   request alias. A non-null `scheduled_at` takes precedence over `send_at`; when
+        #   `scheduled_at` is omitted or null, `send_at` is used.
         #
         #   @return [Time, nil]
         optional :scheduled_at, Time, nil?: true
@@ -148,8 +161,9 @@ module Telnyx
         optional :subject, String
 
         # @!attribute tags
-        #   Tags for categorization and reporting. Stored on the message and propagated to
-        #   Email Detail Records. Not returned in API responses.
+        #   Tags for categorization and filtering. Stored on the message, returned on
+        #   message responses, and propagated to Email Detail Records. Usable in
+        #   `filter[tags]` when listing messages.
         #
         #   @return [Array<String>, nil]
         optional :tags, Telnyx::Internal::Type::ArrayOf[String]
@@ -162,7 +176,10 @@ module Telnyx
         # @!attribute template_variables
         #   Variables for Liquid template rendering. Non-object values may cause a 422
         #   validation error on message creation, but are silently treated as an empty
-        #   object for template rendering.
+        #   object for template rendering. When the template enables `strict_variables`, a
+        #   missing required variable fails the request with 422 (single send) or a per-item
+        #   `unprocessable_entity` error (batch) naming the variable; no message is
+        #   persisted for the failed item.
         #
         #   @return [Hash{Symbol=>Object}, nil]
         optional :template_variables, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
@@ -215,19 +232,19 @@ module Telnyx
         #
         #   @param inline_css [Boolean]
         #
-        #   @param metadata [Hash{Symbol=>Object}] Custom metadata. Write-only; not returned in responses.
+        #   @param metadata [Hash{Symbol=>Object}] Custom metadata key/value pairs. Stored on the message, returned on message resp
         #
         #   @param reply_to [String, Telnyx::Models::EmailInboxes::EmailAddress] Reply-to address. If provided as an object with a name, only the email is stored
         #
-        #   @param sandbox_mode [Boolean]
+        #   @param sandbox_mode [Boolean] Per-message sandbox flag. The batch-level `sandbox_mode` envelope value is autho
         #
-        #   @param scheduled_at [Time, nil] Future ISO 8601 time to schedule sending. Invalid or past timestamps
+        #   @param scheduled_at [Time, nil] Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected. Si
         #
         #   @param send_at [Time] Deprecated alias for `scheduled_at`.
         #
         #   @param subject [String] Required unless `template_id` is supplied. When using a template, the template's
         #
-        #   @param tags [Array<String>] Tags for categorization and reporting. Stored on the message and propagated to E
+        #   @param tags [Array<String>] Tags for categorization and filtering. Stored on the message, returned on messag
         #
         #   @param template_id [String]
         #

data/lib/telnyx/models/email_message_create_params.rb

@@ -101,7 +101,9 @@ module Telnyx
       optional :inline_css, Telnyx::Internal::Type::Boolean
 
       # @!attribute metadata
-      #   Custom metadata. Write-only; not returned in responses.
+      #   Custom metadata key/value pairs. Stored on the message, returned on message
+      #   responses, and propagated to Email Detail Records. Usable in `filter[metadata]`
+      #   when listing messages.
       #
       #   @return [Hash{Symbol=>Object}, nil]
       optional :metadata, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
@@ -127,15 +129,41 @@ module Telnyx
       optional :reply_to_all, Telnyx::Internal::Type::Boolean, nil?: true
 
       # @!attribute sandbox_mode
+      #   Validates and accepts the message without injecting it into the MTA or outbound
+      #   Kafka path. Nothing is delivered: sandbox records are non-billable, consume no
+      #   daily-send-limit quota, and feed no delivery-reputation signals.
+      #
+      #   The reserved sandbox test-recipient domain is `test.telnyx.com`. In sandbox
+      #   mode, these addresses produce deterministic recipient-scoped lifecycle events:
+      #
+      #   - `delivered@test.telnyx.com`: queued -> sending -> sent -> delivered
+      #   - `hard-bounce@test.telnyx.com`: queued -> sending -> sent -> bounced
+      #     (permanent)
+      #   - `soft-bounce@test.telnyx.com`: queued -> sending -> sent -> bounced
+      #     (transient)
+      #   - `complaint@test.telnyx.com`: queued -> sending -> sent -> complained
+      #   - `suppressed@test.telnyx.com`: queued -> suppressed
+      #   - `invalid@test.telnyx.com`: queued -> sending -> failed (invalid recipient)
+      #   - `dkim-fail@test.telnyx.com`: queued -> sending -> failed (DKIM unavailable)
+      #   - `rate-limit@test.telnyx.com`: queued -> sending -> failed (rate limit
+      #     exceeded)
+      #
+      #   Matching is case-insensitive for both the local part and the domain and requires
+      #   the exact domain `test.telnyx.com` — subdomains and other domains do not match.
+      #   Mixed sandbox sends simulate only reserved test recipients; other recipients
+      #   retain ordinary sandbox behavior (accepted, no delivery attempted). Hard-bounce
+      #   and complaint outcomes also use the normal automatic-suppression pipeline.
+      #   Non-sandbox sends to these addresses use the normal delivery path.
       #
       #   @return [Boolean, nil]
       optional :sandbox_mode, Telnyx::Internal::Type::Boolean
 
       # @!attribute scheduled_at
-      #   Future ISO 8601 time to schedule sending. Invalid or past timestamps are
-      #   silently ignored and the email is sent immediately. The legacy alias `send_at`
-      #   is still accepted for backward compatibility; when both are provided,
-      #   `scheduled_at` wins.
+      #   Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected.
+      #   Single sends return HTTP 422; in batch sends the invalid item is reported in the
+      #   207 per-item errors while other items continue. `send_at` remains a deprecated
+      #   request alias. A non-null `scheduled_at` takes precedence over `send_at`; when
+      #   `scheduled_at` is omitted or null, `send_at` is used.
       #
       #   @return [Time, nil]
       optional :scheduled_at, Time, nil?: true
@@ -157,8 +185,9 @@ module Telnyx
       optional :subject, String
 
       # @!attribute tags
-      #   Tags for categorization and reporting. Stored on the message and propagated to
-      #   Email Detail Records. Not returned in API responses.
+      #   Tags for categorization and filtering. Stored on the message, returned on
+      #   message responses, and propagated to Email Detail Records. Usable in
+      #   `filter[tags]` when listing messages.
       #
       #   @return [Array<String>, nil]
       optional :tags, Telnyx::Internal::Type::ArrayOf[String]
@@ -171,7 +200,10 @@ module Telnyx
       # @!attribute template_variables
       #   Variables for Liquid template rendering. Non-object values may cause a 422
       #   validation error on message creation, but are silently treated as an empty
-      #   object for template rendering.
+      #   object for template rendering. When the template enables `strict_variables`, a
+      #   missing required variable fails the request with 422 (single send) or a per-item
+      #   `unprocessable_entity` error (batch) naming the variable; no message is
+      #   persisted for the failed item.
       #
       #   @return [Hash{Symbol=>Object}, nil]
       optional :template_variables, Telnyx::Internal::Type::HashOf[Telnyx::Internal::Type::Unknown]
@@ -225,21 +257,21 @@ module Telnyx
       #
       #   @param inline_css [Boolean]
       #
-      #   @param metadata [Hash{Symbol=>Object}] Custom metadata. Write-only; not returned in responses.
+      #   @param metadata [Hash{Symbol=>Object}] Custom metadata key/value pairs. Stored on the message, returned on message resp
       #
       #   @param reply_to [String, Telnyx::Models::EmailInboxes::EmailAddress] Reply-to address. If provided as an object with a name, only the email is stored
       #
       #   @param reply_to_all [Boolean, nil] Indicates a reply-all intent. In Phase 1 (wire-only) this does not
       #
-      #   @param sandbox_mode [Boolean]
+      #   @param sandbox_mode [Boolean] Validates and accepts the message without injecting it into the MTA or outbound
       #
-      #   @param scheduled_at [Time, nil] Future ISO 8601 time to schedule sending. Invalid or past timestamps
+      #   @param scheduled_at [Time, nil] Future ISO 8601 delivery time. Invalid or non-future timestamps are rejected. Si
       #
       #   @param send_at [Time] Deprecated alias for `scheduled_at`.
       #
       #   @param subject [String] Required unless `template_id` is supplied. When using a template, the template's
       #
-      #   @param tags [Array<String>] Tags for categorization and reporting. Stored on the message and propagated to E
+      #   @param tags [Array<String>] Tags for categorization and filtering. Stored on the message, returned on messag
       #
       #   @param template_id [String]
       #

data/lib/telnyx/models/{email_message_retrieve_response.rb → email_message_detail_response.rb}

@@ -3,16 +3,16 @@
 module Telnyx
   module Models
     # @see Telnyx::Resources::EmailMessages#retrieve
-    class EmailMessageRetrieveResponse < Telnyx::Internal::Type::BaseModel
+    class EmailMessageDetailResponse < Telnyx::Internal::Type::BaseModel
       # @!attribute data
       #
-      #   @return [Telnyx::Models::EmailMessageRetrieveResponse::Data]
-      required :data, -> { Telnyx::Models::EmailMessageRetrieveResponse::Data }
+      #   @return [Telnyx::Models::EmailMessageDetailResponse::Data]
+      required :data, -> { Telnyx::EmailMessageDetailResponse::Data }
 
       # @!method initialize(data:)
-      #   @param data [Telnyx::Models::EmailMessageRetrieveResponse::Data]
+      #   @param data [Telnyx::Models::EmailMessageDetailResponse::Data]
 
-      # @see Telnyx::Models::EmailMessageRetrieveResponse#data
+      # @see Telnyx::Models::EmailMessageDetailResponse#data
       class Data < Telnyx::Models::EmailInboxes::EmailMessage
         # @!attribute html_body
         #   HTML body submitted for the message.

data/lib/telnyx/models/email_message_list_params.rb

@@ -7,6 +7,27 @@ module Telnyx
       extend Telnyx::Internal::Type::RequestParameters::Converter
       include Telnyx::Internal::Type::RequestParameters
 
+      # @!attribute filter_metadata
+      #   Metadata containment filter, supplied as a JSON object or comma-separated
+      #   `key=value` pairs. All supplied key/value pairs must be contained in the message
+      #   metadata. An empty value or empty JSON object omits the filter. Malformed
+      #   values, valid non-object JSON, pairs without `=`, empty keys, and
+      #   non-string/nested query shapes return HTTP 400.
+      #
+      #   @return [String, nil]
+      optional :filter_metadata, String
+
+      # @!attribute filter_tags
+      #   Comma-separated tags. Each segment is trimmed, and messages having at least one
+      #   supplied tag are returned; matching is exact and case-sensitive after trimming.
+      #   Because commas delimit values and surrounding whitespace is removed, this filter
+      #   cannot represent stored tags containing literal commas or leading/trailing
+      #   whitespace. An empty value omits the filter. Empty segments and
+      #   non-string/nested query shapes return HTTP 400.
+      #
+      #   @return [String, nil]
+      optional :filter_tags, String
+
       # @!attribute page_cursor
       #   Opaque URL-safe Base64 cursor returned by a previous list response.
       #
@@ -20,10 +41,14 @@ module Telnyx
       #   @return [Integer, nil]
       optional :page_size, Integer
 
-      # @!method initialize(page_cursor: nil, page_size: nil, request_options: {})
+      # @!method initialize(filter_metadata: nil, filter_tags: nil, page_cursor: nil, page_size: nil, request_options: {})
       #   Some parameter documentations has been truncated, see
       #   {Telnyx::Models::EmailMessageListParams} for more details.
       #
+      #   @param filter_metadata [String] Metadata containment filter, supplied as a JSON object or comma-separated `key=v
+      #
+      #   @param filter_tags [String] Comma-separated tags. Each segment is trimmed, and messages having at least one
+      #
       #   @param page_cursor [String] Opaque URL-safe Base64 cursor returned by a previous list response.
       #
       #   @param page_size [Integer] Number of results to return. Defaults to 25; maximum is 100. Invalid values are

data/lib/telnyx/models/email_message_update_schedule_params.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    # @see Telnyx::Resources::EmailMessages#update_schedule
+    class EmailMessageUpdateScheduleParams < Telnyx::Internal::Type::BaseModel
+      extend Telnyx::Internal::Type::RequestParameters::Converter
+      include Telnyx::Internal::Type::RequestParameters
+
+      # @!attribute email_id
+      #
+      #   @return [String]
+      required :email_id, String
+
+      # @!attribute scheduled_at
+      #   New ISO 8601 delivery time. Must be strictly in the future.
+      #
+      #   @return [Time]
+      required :scheduled_at, Time
+
+      # @!method initialize(email_id:, scheduled_at:, request_options: {})
+      #   @param email_id [String]
+      #
+      #   @param scheduled_at [Time] New ISO 8601 delivery time. Must be strictly in the future.
+      #
+      #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/telnyx/models/email_messages/email_recipient.rb

@@ -134,6 +134,8 @@ module Telnyx
           FAILED = :failed
           GW_REJECT = :gw_reject
           CANCELLED = :cancelled
+          INJECTION_TIMEOUT = :injection_timeout
+          EXPIRED = :expired
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/telnyx/models/email_messages/recipient_list_params.rb

@@ -79,6 +79,8 @@ module Telnyx
           FAILED = :failed
           GW_REJECT = :gw_reject
           CANCELLED = :cancelled
+          INJECTION_TIMEOUT = :injection_timeout
+          EXPIRED = :expired
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/telnyx/models/email_template.rb

@@ -9,6 +9,14 @@ module Telnyx
       #   @return [String]
       required :id, String
 
+      # @!attribute autoescape
+      #   Whether HTML autoescaping is enabled for this template. When `true`, only
+      #   rendered `html_body` expression output is HTML-escaped at the output boundary;
+      #   `subject` and `text_body` are never autoescaped.
+      #
+      #   @return [Boolean]
+      required :autoescape, Telnyx::Internal::Type::Boolean
+
       # @!attribute created_at
       #
       #   @return [Time]
@@ -29,6 +37,14 @@ module Telnyx
       #   @return [Symbol, Telnyx::Models::EmailTemplate::RecordType]
       required :record_type, enum: -> { Telnyx::EmailTemplate::RecordType }
 
+      # @!attribute strict_variables
+      #   Whether strict variable validation is enabled for this template. When `true`,
+      #   sends and renders that are missing a variable marked `required: true` in
+      #   `variable_schema` fail with 422 naming the variable.
+      #
+      #   @return [Boolean]
+      required :strict_variables, Telnyx::Internal::Type::Boolean
+
       # @!attribute subject
       #
       #   @return [String, nil]
@@ -44,21 +60,48 @@ module Telnyx
       #   @return [Time]
       required :updated_at, Time
 
+      # @!attribute variable_schema
+      #   Structured variable requirements, or `null` when the template uses only the
+      #   legacy `variables` array.
+      #
+      #   @return [Hash{Symbol=>Telnyx::Models::EmailTemplate::VariableSchema}, nil]
+      required :variable_schema,
+               -> { Telnyx::Internal::Type::HashOf[Telnyx::EmailTemplate::VariableSchema] },
+               nil?: true
+
       # @!attribute variables
+      #   Legacy unstructured variable names. This path remains supported unchanged.
       #
       #   @return [Array<String>]
       required :variables, Telnyx::Internal::Type::ArrayOf[String]
 
-      # @!method initialize(id:, created_at:, html_body:, name:, record_type:, subject:, text_body:, updated_at:, variables:)
+      # @!method initialize(id:, autoescape:, created_at:, html_body:, name:, record_type:, strict_variables:, subject:, text_body:, updated_at:, variable_schema:, variables:)
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::EmailTemplate} for more details.
+      #
       #   @param id [String]
+      #
+      #   @param autoescape [Boolean] Whether HTML autoescaping is enabled for this template. When `true`, only render
+      #
       #   @param created_at [Time]
+      #
       #   @param html_body [String, nil]
+      #
       #   @param name [String]
+      #
       #   @param record_type [Symbol, Telnyx::Models::EmailTemplate::RecordType]
+      #
+      #   @param strict_variables [Boolean] Whether strict variable validation is enabled for this template. When `true`, se
+      #
       #   @param subject [String, nil]
+      #
       #   @param text_body [String, nil]
+      #
       #   @param updated_at [Time]
-      #   @param variables [Array<String>]
+      #
+      #   @param variable_schema [Hash{Symbol=>Telnyx::Models::EmailTemplate::VariableSchema}, nil] Structured variable requirements, or `null` when the template uses only the lega
+      #
+      #   @param variables [Array<String>] Legacy unstructured variable names. This path remains supported unchanged.
 
       # @see Telnyx::Models::EmailTemplate#record_type
       module RecordType
@@ -69,6 +112,29 @@ module Telnyx
         # @!method self.values
         #   @return [Array<Symbol>]
       end
+
+      class VariableSchema < Telnyx::Internal::Type::BaseModel
+        # @!attribute required
+        #   Whether the variable must be supplied when strict variable validation is
+        #   enabled.
+        #
+        #   @return [Boolean]
+        required :required, Telnyx::Internal::Type::Boolean
+
+        # @!attribute default
+        #   Default value for an optional variable. Rejected when `required` is `true`.
+        #
+        #   @return [String, nil]
+        optional :default, String
+
+        # @!method initialize(required:, default: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::EmailTemplate::VariableSchema} for more details.
+        #
+        #   @param required [Boolean] Whether the variable must be supplied when strict variable validation is enabled
+        #
+        #   @param default [String] Default value for an optional variable. Rejected when `required` is `true`.
+      end
     end
   end
 end

data/lib/telnyx/models/email_template_create_params.rb

@@ -13,12 +13,36 @@ module Telnyx
       #   @return [String]
       required :name, String
 
+      # @!attribute autoescape
+      #   Per-template HTML autoescaping setting. Defaults to `false` for backward
+      #   compatibility. When `true`, the rendered `html_body` HTML-escapes each Liquid
+      #   expression's output at the output boundary (after its filters run, before
+      #   concatenation with literal template markup). Input values are never mutated and
+      #   `subject`/`text_body` are never autoescaped. The boundary escape is idempotent:
+      #   HTML entities already present in the output (e.g. from an explicit `escape`
+      #   filter) are preserved, so an explicit `escape`/`escape_once` is never
+      #   double-escaped, and markup introduced by any later filter in the chain is still
+      #   escaped.
+      #
+      #   @return [Boolean, nil]
+      optional :autoescape, Telnyx::Internal::Type::Boolean
+
       # @!attribute html_body
       #   Liquid template HTML body.
       #
       #   @return [String, nil]
       optional :html_body, String, nil?: true
 
+      # @!attribute strict_variables
+      #   Per-template strict variable-validation setting. Defaults to `false` for
+      #   backward compatibility. When `true`, a send or render that is missing a variable
+      #   marked `required: true` in `variable_schema` fails with 422 naming the variable.
+      #   Missing optional variables never fail; their schema `default` (when set) is
+      #   applied to the render.
+      #
+      #   @return [Boolean, nil]
+      optional :strict_variables, Telnyx::Internal::Type::Boolean
+
       # @!attribute subject
       #   Liquid template subject.
       #
@@ -31,6 +55,20 @@ module Telnyx
       #   @return [String, nil]
       optional :text_body, String, nil?: true
 
+      # @!attribute variable_schema
+      #   Structured variable requirements. Required variables cannot define defaults;
+      #   invalid combinations return 422. This is independent of the legacy `variables`
+      #   array. On render with `strict_variables` enabled: `required` variables must be
+      #   supplied as non-empty values — absent, `null`, empty string, empty object `{}`,
+      #   and empty array `[]` all fail with 422 naming the variable, while present values
+      #   such as `false` and `0` pass (they are present, not empty). Optional variables
+      #   fall back to their `default` when absent.
+      #
+      #   @return [Hash{Symbol=>Telnyx::Models::EmailTemplateCreateParams::VariableSchema}, nil]
+      optional :variable_schema,
+               -> { Telnyx::Internal::Type::HashOf[Telnyx::EmailTemplateCreateParams::VariableSchema] },
+               nil?: true
+
       # @!attribute variables
       #   Template variables. Auto-extracted from subject/body fields when absent.
       #
@@ -42,20 +80,52 @@ module Telnyx
       #   @return [String, nil]
       optional :idempotency_key, String
 
-      # @!method initialize(name:, html_body: nil, subject: nil, text_body: nil, variables: nil, idempotency_key: nil, request_options: {})
+      # @!method initialize(name:, autoescape: nil, html_body: nil, strict_variables: nil, subject: nil, text_body: nil, variable_schema: nil, variables: nil, idempotency_key: nil, request_options: {})
+      #   Some parameter documentations has been truncated, see
+      #   {Telnyx::Models::EmailTemplateCreateParams} for more details.
+      #
       #   @param name [String] Letters, numbers, spaces, hyphens, and underscores only.
       #
+      #   @param autoescape [Boolean] Per-template HTML autoescaping setting. Defaults to `false` for backward compati
+      #
       #   @param html_body [String, nil] Liquid template HTML body.
       #
+      #   @param strict_variables [Boolean] Per-template strict variable-validation setting. Defaults to `false` for backwar
+      #
       #   @param subject [String, nil] Liquid template subject.
       #
       #   @param text_body [String, nil] Liquid template text body.
       #
+      #   @param variable_schema [Hash{Symbol=>Telnyx::Models::EmailTemplateCreateParams::VariableSchema}, nil] Structured variable requirements. Required variables cannot define defaults; inv
+      #
       #   @param variables [Array<String>] Template variables. Auto-extracted from subject/body fields when absent.
       #
       #   @param idempotency_key [String]
       #
       #   @param request_options [Telnyx::RequestOptions, Hash{Symbol=>Object}]
+
+      class VariableSchema < Telnyx::Internal::Type::BaseModel
+        # @!attribute required
+        #   Whether the variable must be supplied when strict variable validation is
+        #   enabled.
+        #
+        #   @return [Boolean]
+        required :required, Telnyx::Internal::Type::Boolean
+
+        # @!attribute default
+        #   Default value for an optional variable. Rejected when `required` is `true`.
+        #
+        #   @return [String, nil]
+        optional :default, String
+
+        # @!method initialize(required:, default: nil)
+        #   Some parameter documentations has been truncated, see
+        #   {Telnyx::Models::EmailTemplateCreateParams::VariableSchema} for more details.
+        #
+        #   @param required [Boolean] Whether the variable must be supplied when strict variable validation is enabled
+        #
+        #   @param default [String] Default value for an optional variable. Rejected when `required` is `true`.
+      end
     end
   end
 end

data/lib/telnyx/models/email_webhook_recipient.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Telnyx
+  module Models
+    class EmailWebhookRecipient < Telnyx::Internal::Type::BaseModel
+      # @!attribute email
+      #
+      #   @return [String]
+      required :email, String
+
+      # @!attribute kind
+      #
+      #   @return [Symbol, Telnyx::Models::EmailWebhookRecipient::Kind, nil]
+      optional :kind, enum: -> { Telnyx::EmailWebhookRecipient::Kind }
+
+      # @!attribute name
+      #
+      #   @return [String, nil]
+      optional :name, String, nil?: true
+
+      # @!method initialize(email:, kind: nil, name: nil)
+      #   @param email [String]
+      #   @param kind [Symbol, Telnyx::Models::EmailWebhookRecipient::Kind]
+      #   @param name [String, nil]
+
+      # @see Telnyx::Models::EmailWebhookRecipient#kind
+      module Kind
+        extend Telnyx::Internal::Type::Enum
+
+        TO = :to
+        CC = :cc
+        BCC = :bcc
+
+        # @!method self.values
+        #   @return [Array<Symbol>]
+      end
+    end
+  end
+end