sentdm 0.3.1 → 0.5.0

data/lib/sentdm/resources/profiles.rb

@@ -4,6 +4,10 @@ module Sentdm
   module Resources
     # Manage organization profiles
     class Profiles
+      # Manage organization profiles
+      # @return [Sentdm::Resources::Profiles::Campaigns]
+      attr_reader :campaigns
+
       # Some parameter documentations has been truncated, see
       # {Sentdm::Models::ProfileCreateParams} for more details.
       #
@@ -11,14 +15,51 @@ module Sentdm
       # different brands, departments, or use cases, each with their own messaging
       # configuration and settings. Requires admin role in the organization.
       #
-      # @overload create(allow_contact_sharing: nil, allow_template_sharing: nil, billing_model: nil, description: nil, icon: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil, name: nil, short_name: nil, test_mode: nil, idempotency_key: nil, request_options: {})
+      # ## WhatsApp Business Account
+      #
+      # Every profile must be linked to a WhatsApp Business Account. There are two ways
+      # to do this:
+      #
+      # **1. Inherit from organization (default)** — Omit the
+      # `whatsapp_business_account` field. The profile will share the organization's
+      # WhatsApp Business Account, which must have been set up via WhatsApp Embedded
+      # Signup. This is the recommended path for most use cases.
+      #
+      # **2. Direct credentials** — Provide a `whatsapp_business_account` object with
+      # `waba_id`, `phone_number_id`, and `access_token`. Use this when the profile
+      # needs its own independent WhatsApp Business Account. Obtain these from Meta
+      # Business Manager by creating a System User with `whatsapp_business_messaging`
+      # and `whatsapp_business_management` permissions.
+      #
+      # If the `whatsapp_business_account` field is omitted and the organization has no
+      # WhatsApp Business Account configured, the request will be rejected with
+      # HTTP 422.
+      #
+      # ## Brand
+      #
+      # Include the optional `brand` field to create the brand for this profile at the
+      # same time. Cannot be used when `inherit_tcr_brand` is `true`.
+      #
+      # ## Payment Details
+      #
+      # When `billing_model` is `"profile"` or `"profile_and_organization"` you may
+      # include a `payment_details` object containing the card number, expiry (MM/YY),
+      # CVC, and billing ZIP code. Payment details are **never stored** on our servers
+      # and are forwarded directly to the payment processor. Providing `payment_details`
+      # when `billing_model` is `"organization"` is not allowed.
+      #
+      # @overload create(allow_contact_sharing: nil, allow_template_sharing: nil, billing_contact: nil, billing_model: nil, brand: nil, description: nil, icon: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil, name: nil, payment_details: nil, sandbox: nil, short_name: nil, whatsapp_business_account: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
       # @param allow_contact_sharing [Boolean] Body param: Whether contacts are shared across profiles (default: false)
       #
       # @param allow_template_sharing [Boolean] Body param: Whether templates are shared across profiles (default: false)
       #
+      # @param billing_contact [Sentdm::Models::BillingContactInfo, nil] Body param: Billing contact for this profile. Required when billing_model is "pr
+      #
       # @param billing_model [String, nil] Body param: Billing model: profile, organization, or profile_and_organization (d
       #
+      # @param brand [Sentdm::Models::BrandsBrandData, nil] Body param: Brand and KYC information for this profile (optional).
+      #
       # @param description [String, nil] Body param: Profile description (optional)
       #
       # @param icon [String, nil] Body param: Profile icon URL (optional)
@@ -33,12 +74,18 @@ module Sentdm
       #
       # @param name [String] Body param: Profile name (required)
       #
-      # @param short_name [String, nil] Body param: Profile short name/abbreviation (optional)
+      # @param payment_details [Sentdm::Models::PaymentDetails, nil] Body param: Payment card details for this profile (optional).
+      #
+      # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
+      #
+      # @param short_name [String, nil] Body param: Profile short name/abbreviation (optional). Must be 3–11 characters,
       #
-      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      # @param whatsapp_business_account [Sentdm::Models::ProfileCreateParams::WhatsappBusinessAccount, nil] Body param: Direct WhatsApp Business Account credentials for this profile.
       #
       # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Sentdm::Models::APIResponseOfProfileDetail]
@@ -46,7 +93,7 @@ module Sentdm
       # @see Sentdm::Models::ProfileCreateParams
       def create(params = {})
         parsed, options = Sentdm::ProfileCreateParams.dump_request(params)
-        header_params = {idempotency_key: "idempotency-key"}
+        header_params = {idempotency_key: "idempotency-key", x_profile_id: "x-profile-id"}
         @client.request(
           method: :post,
           path: "v3/profiles",
@@ -57,23 +104,32 @@ module Sentdm
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::ProfileRetrieveParams} for more details.
+      #
       # Retrieves detailed information about a specific sender profile within an
-      # organization.
+      # organization, including brand and KYC information if a brand has been
+      # configured.
       #
-      # @overload retrieve(profile_id, request_options: {})
+      # @overload retrieve(profile_id, x_profile_id: nil, request_options: {})
       #
       # @param profile_id [String]
+      #
+      # @param x_profile_id [String] Profile UUID to scope the request to a child profile. Only organization API keys
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Sentdm::Models::APIResponseOfProfileDetail]
       #
       # @see Sentdm::Models::ProfileRetrieveParams
       def retrieve(profile_id, params = {})
+        parsed, options = Sentdm::ProfileRetrieveParams.dump_request(params)
         @client.request(
           method: :get,
           path: ["v3/profiles/%1$s", profile_id],
+          headers: parsed.transform_keys(x_profile_id: "x-profile-id"),
           model: Sentdm::APIResponseOfProfileDetail,
-          options: params[:request_options]
+          options: options
         )
       end
 
@@ -83,9 +139,25 @@ module Sentdm
       # Updates a profile's configuration and settings. Requires admin role in the
       # organization. Only provided fields will be updated (partial update).
       #
-      # @overload update(path_profile_id, allow_contact_sharing: nil, allow_number_change_during_onboarding: nil, allow_template_sharing: nil, billing_model: nil, description: nil, icon: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil, name: nil, body_profile_id: nil, sending_phone_number: nil, sending_phone_number_profile_id: nil, sending_whatsapp_number_profile_id: nil, short_name: nil, test_mode: nil, whatsapp_phone_number: nil, idempotency_key: nil, request_options: {})
+      # ## Brand Management
+      #
+      # Include the optional `brand` field to create or update the brand associated with
+      # this profile. The brand holds KYC and TCR compliance data (legal business info,
+      # contact details, messaging vertical). Once a brand has been submitted to TCR it
+      # cannot be modified. Setting `inherit_tcr_brand: true` and providing `brand` in
+      # the same request is not allowed.
+      #
+      # ## Payment Details
+      #
+      # When `billing_model` is `"profile"` or `"profile_and_organization"` you may
+      # include a `payment_details` object containing the card number, expiry (MM/YY),
+      # CVC, and billing ZIP code. Payment details are **never stored** on our servers
+      # and are forwarded directly to the payment processor. Providing `payment_details`
+      # when `billing_model` is `"organization"` is not allowed.
       #
-      # @param path_profile_id [String] Path param
+      # @overload update(profile_id, allow_contact_sharing: nil, allow_number_change_during_onboarding: nil, allow_template_sharing: nil, billing_contact: nil, billing_model: nil, brand: nil, description: nil, icon: nil, inherit_contacts: nil, inherit_tcr_brand: nil, inherit_tcr_campaign: nil, inherit_templates: nil, name: nil, payment_details: nil, sandbox: nil, sending_phone_number: nil, sending_phone_number_profile_id: nil, sending_whatsapp_number_profile_id: nil, short_name: nil, whatsapp_phone_number: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
+      #
+      # @param profile_id [String] Path param
       #
       # @param allow_contact_sharing [Boolean, nil] Body param: Whether contacts are shared across profiles (optional)
       #
@@ -93,8 +165,12 @@ module Sentdm
       #
       # @param allow_template_sharing [Boolean, nil] Body param: Whether templates are shared across profiles (optional)
       #
+      # @param billing_contact [Sentdm::Models::BillingContactInfo, nil] Body param: Billing contact for this profile. Required when billing_model is "pr
+      #
       # @param billing_model [String, nil] Body param: Billing model: profile, organization, or profile_and_organization (o
       #
+      # @param brand [Sentdm::Models::BrandsBrandData, nil] Body param: Brand and KYC information for this profile (optional).
+      #
       # @param description [String, nil] Body param: Profile description (optional)
       #
       # @param icon [String, nil] Body param: Profile icon URL (optional)
@@ -109,7 +185,9 @@ module Sentdm
       #
       # @param name [String, nil] Body param: Profile name (optional)
       #
-      # @param body_profile_id [String] Body param: Profile ID from route parameter
+      # @param payment_details [Sentdm::Models::PaymentDetails, nil] Body param: Payment card details for this profile (optional).
+      #
+      # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
       #
       # @param sending_phone_number [String, nil] Body param: Direct phone number for SMS sending (optional)
       #
@@ -117,25 +195,25 @@ module Sentdm
       #
       # @param sending_whatsapp_number_profile_id [String, nil] Body param: Reference to another profile to use for WhatsApp configuration (opti
       #
-      # @param short_name [String, nil] Body param: Profile short name/abbreviation (optional)
-      #
-      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      # @param short_name [String, nil] Body param: Profile short name/abbreviation (optional). Must be 3–11 characters,
       #
       # @param whatsapp_phone_number [String, nil] Body param: Direct phone number for WhatsApp sending (optional)
       #
       # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Sentdm::Models::APIResponseOfProfileDetail]
       #
       # @see Sentdm::Models::ProfileUpdateParams
-      def update(path_profile_id, params = {})
+      def update(profile_id, params = {})
         parsed, options = Sentdm::ProfileUpdateParams.dump_request(params)
-        header_params = {idempotency_key: "idempotency-key"}
+        header_params = {idempotency_key: "idempotency-key", x_profile_id: "x-profile-id"}
         @client.request(
           method: :patch,
-          path: ["v3/profiles/%1$s", path_profile_id],
+          path: ["v3/profiles/%1$s", profile_id],
           headers: parsed.slice(*header_params.keys).transform_keys(header_params),
           body: parsed.except(*header_params.keys),
           model: Sentdm::APIResponseOfProfileDetail,
@@ -143,11 +221,17 @@ module Sentdm
         )
       end
 
-      # Retrieves all sender profiles within an organization. Profiles represent
-      # different brands, departments, or use cases within an organization, each with
-      # their own messaging configuration.
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::ProfileListParams} for more details.
+      #
+      # Retrieves all sender profiles within an organization, including brand
+      # information for each profile. Profiles represent different brands, departments,
+      # or use cases within an organization, each with their own messaging
+      # configuration.
       #
-      # @overload list(request_options: {})
+      # @overload list(x_profile_id: nil, request_options: {})
+      #
+      # @param x_profile_id [String] Profile UUID to scope the request to a child profile. Only organization API keys
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -155,11 +239,13 @@ module Sentdm
       #
       # @see Sentdm::Models::ProfileListParams
       def list(params = {})
+        parsed, options = Sentdm::ProfileListParams.dump_request(params)
         @client.request(
           method: :get,
           path: "v3/profiles",
+          headers: parsed.transform_keys(x_profile_id: "x-profile-id"),
           model: Sentdm::Models::ProfileListResponse,
-          options: params[:request_options]
+          options: options
         )
       end
 
@@ -169,33 +255,33 @@ module Sentdm
       # Soft deletes a sender profile. The profile will be marked as deleted but data is
       # retained. Requires admin role in the organization.
       #
-      # @overload delete(path_profile_id, body_profile_id: nil, test_mode: nil, request_options: {})
+      # @overload delete(profile_id, body:, x_profile_id: nil, request_options: {})
       #
-      # @param path_profile_id [String]
+      # @param profile_id [String] Path param
       #
-      # @param body_profile_id [String] Profile ID from route parameter
+      # @param body [Sentdm::Models::ProfileDeleteParams::Body] Body param: Request to delete a profile
       #
-      # @param test_mode [Boolean] Test mode flag - when true, the operation is simulated without side effects
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [nil]
       #
       # @see Sentdm::Models::ProfileDeleteParams
-      def delete(path_profile_id, params = {})
+      def delete(profile_id, params)
         parsed, options = Sentdm::ProfileDeleteParams.dump_request(params)
         @client.request(
           method: :delete,
-          path: ["v3/profiles/%1$s", path_profile_id],
-          headers: {"content-type" => "*/*"},
-          body: parsed,
+          path: ["v3/profiles/%1$s", profile_id],
+          headers: parsed.except(:body).transform_keys(x_profile_id: "x-profile-id"),
+          body: parsed[:body],
           model: NilClass,
           options: options
         )
       end
 
       # Some parameter documentations has been truncated, see
-      # {Sentdm::Models::ProfileCompleteParams} for more details.
+      # {Sentdm::Models::ProfileCompleteSetupParams} for more details.
       #
       # Final step in profile compliance workflow. Validates all prerequisites (general
       # data, brand, campaigns), connects profile to Telnyx/WhatsApp, and sets status
@@ -216,24 +302,26 @@ module Sentdm
       #                 - If non-TCR with destination country (IsMain=true) → SUBMITTED
       #                 - Otherwise → COMPLETED
       #
-      # @overload complete(profile_id, web_hook_url:, test_mode: nil, idempotency_key: nil, request_options: {})
+      # @overload complete_setup(profile_id, web_hook_url:, sandbox: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
       # @param profile_id [String] Path param: Profile ID from route
       #
       # @param web_hook_url [String] Body param: Webhook URL to call when profile completion finishes (success or fai
       #
-      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
       #
       # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Object]
       #
-      # @see Sentdm::Models::ProfileCompleteParams
-      def complete(profile_id, params)
-        parsed, options = Sentdm::ProfileCompleteParams.dump_request(params)
-        header_params = {idempotency_key: "idempotency-key"}
+      # @see Sentdm::Models::ProfileCompleteSetupParams
+      def complete_setup(profile_id, params)
+        parsed, options = Sentdm::ProfileCompleteSetupParams.dump_request(params)
+        header_params = {idempotency_key: "idempotency-key", x_profile_id: "x-profile-id"}
         @client.request(
           method: :post,
           path: ["v3/profiles/%1$s/complete", profile_id],
@@ -249,6 +337,7 @@ module Sentdm
       # @param client [Sentdm::Client]
       def initialize(client:)
         @client = client
+        @campaigns = Sentdm::Resources::Profiles::Campaigns.new(client: client)
       end
     end
   end

data/lib/sentdm/resources/templates.rb

@@ -11,7 +11,7 @@ module Sentdm
       # template can be submitted for review immediately or saved as draft for later
       # submission.
       #
-      # @overload create(category: nil, creation_source: nil, definition: nil, language: nil, submit_for_review: nil, test_mode: nil, idempotency_key: nil, request_options: {})
+      # @overload create(category: nil, creation_source: nil, definition: nil, language: nil, sandbox: nil, submit_for_review: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
       # @param category [String, nil] Body param: Template category: MARKETING, UTILITY, AUTHENTICATION (optional, aut
       #
@@ -21,12 +21,14 @@ module Sentdm
       #
       # @param language [String, nil] Body param: Template language code (e.g., en_US) (optional, auto-detected if not
       #
-      # @param submit_for_review [Boolean] Body param: Whether to submit the template for review after creation (default: f
+      # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
       #
-      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      # @param submit_for_review [Boolean] Body param: Whether to submit the template for review after creation (default: f
       #
       # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Sentdm::Models::APIResponseTemplate]
@@ -34,7 +36,7 @@ module Sentdm
       # @see Sentdm::Models::TemplateCreateParams
       def create(params = {})
         parsed, options = Sentdm::TemplateCreateParams.dump_request(params)
-        header_params = {idempotency_key: "idempotency-key"}
+        header_params = {idempotency_key: "idempotency-key", x_profile_id: "x-profile-id"}
         @client.request(
           method: :post,
           path: "v3/templates",
@@ -45,24 +47,31 @@ module Sentdm
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::TemplateRetrieveParams} for more details.
+      #
       # Retrieves a specific template by its ID. Returns template details including
       # name, category, language, status, and definition.
       #
-      # @overload retrieve(id, request_options: {})
+      # @overload retrieve(id, x_profile_id: nil, request_options: {})
       #
       # @param id [String] Template ID from route parameter
       #
+      # @param x_profile_id [String] Profile UUID to scope the request to a child profile. Only organization API keys
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Sentdm::Models::APIResponseTemplate]
       #
       # @see Sentdm::Models::TemplateRetrieveParams
       def retrieve(id, params = {})
+        parsed, options = Sentdm::TemplateRetrieveParams.dump_request(params)
         @client.request(
           method: :get,
           path: ["v3/templates/%1$s", id],
+          headers: parsed.transform_keys(x_profile_id: "x-profile-id"),
           model: Sentdm::APIResponseTemplate,
-          options: params[:request_options]
+          options: options
         )
       end
 
@@ -72,7 +81,7 @@ module Sentdm
       # Updates an existing template's name, category, language, definition, or submits
       # it for review.
       #
-      # @overload update(id, category: nil, definition: nil, language: nil, name: nil, submit_for_review: nil, test_mode: nil, idempotency_key: nil, request_options: {})
+      # @overload update(id, category: nil, definition: nil, language: nil, name: nil, sandbox: nil, submit_for_review: nil, idempotency_key: nil, x_profile_id: nil, request_options: {})
       #
       # @param id [String] Path param: Template ID from route parameter
       #
@@ -84,12 +93,14 @@ module Sentdm
       #
       # @param name [String, nil] Body param: Template display name
       #
-      # @param submit_for_review [Boolean] Body param: Whether to submit the template for review after updating (default: f
+      # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
       #
-      # @param test_mode [Boolean] Body param: Test mode flag - when true, the operation is simulated without side
+      # @param submit_for_review [Boolean] Body param: Whether to submit the template for review after updating (default: f
       #
       # @param idempotency_key [String] Header param: Unique key to ensure idempotent request processing. Must be 1-255
       #
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
+      #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
       # @return [Sentdm::Models::APIResponseTemplate]
@@ -97,7 +108,7 @@ module Sentdm
       # @see Sentdm::Models::TemplateUpdateParams
       def update(id, params = {})
         parsed, options = Sentdm::TemplateUpdateParams.dump_request(params)
-        header_params = {idempotency_key: "idempotency-key"}
+        header_params = {idempotency_key: "idempotency-key", x_profile_id: "x-profile-id"}
         @client.request(
           method: :put,
           path: ["v3/templates/%1$s", id],
@@ -108,20 +119,27 @@ module Sentdm
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Sentdm::Models::TemplateListParams} for more details.
+      #
       # Retrieves a paginated list of message templates for the authenticated customer.
       # Supports filtering by status, category, and search term.
       #
-      # @overload list(page:, page_size:, category: nil, search: nil, status: nil, request_options: {})
+      # @overload list(page:, page_size:, category: nil, is_welcome_playground: nil, search: nil, status: nil, x_profile_id: nil, request_options: {})
+      #
+      # @param page [Integer] Query param: Page number (1-indexed)
       #
-      # @param page [Integer] Page number (1-indexed)
+      # @param page_size [Integer] Query param: Number of items per page
       #
-      # @param page_size [Integer]
+      # @param category [String, nil] Query param: Optional category filter: MARKETING, UTILITY, AUTHENTICATION
       #
-      # @param category [String, nil] Optional category filter: MARKETING, UTILITY, AUTHENTICATION
+      # @param is_welcome_playground [Boolean, nil] Query param: Optional filter by welcome playground flag
       #
-      # @param search [String, nil] Optional search term for filtering templates
+      # @param search [String, nil] Query param: Optional search term for filtering templates
       #
-      # @param status [String, nil] Optional status filter: APPROVED, PENDING, REJECTED
+      # @param status [String, nil] Query param: Optional status filter: APPROVED, PENDING, REJECTED
+      #
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -129,12 +147,14 @@ module Sentdm
       #
       # @see Sentdm::Models::TemplateListParams
       def list(params)
+        query_params = [:page, :page_size, :category, :is_welcome_playground, :search, :status]
         parsed, options = Sentdm::TemplateListParams.dump_request(params)
-        query = Sentdm::Internal::Util.encode_query_params(parsed)
+        query = Sentdm::Internal::Util.encode_query_params(parsed.slice(*query_params))
         @client.request(
           method: :get,
           path: "v3/templates",
-          query: query.transform_keys(page_size: "pageSize"),
+          query: query,
+          headers: parsed.except(*query_params).transform_keys(x_profile_id: "x-profile-id"),
           model: Sentdm::Models::TemplateListResponse,
           options: options
         )
@@ -146,13 +166,15 @@ module Sentdm
       # Deletes a template by ID. Optionally, you can also delete the template from
       # WhatsApp/Meta by setting delete_from_meta=true.
       #
-      # @overload delete(id, delete_from_meta: nil, test_mode: nil, request_options: {})
+      # @overload delete(id, delete_from_meta: nil, sandbox: nil, x_profile_id: nil, request_options: {})
       #
-      # @param id [String] Template ID from route parameter
+      # @param id [String] Path param: Template ID from route parameter
+      #
+      # @param delete_from_meta [Boolean, nil] Body param: Whether to also delete the template from WhatsApp/Meta (optional, de
       #
-      # @param delete_from_meta [Boolean, nil] Whether to also delete the template from WhatsApp/Meta (optional, defaults to fa
+      # @param sandbox [Boolean] Body param: Sandbox flag - when true, the operation is simulated without side ef
       #
-      # @param test_mode [Boolean] Test mode flag - when true, the operation is simulated without side effects
+      # @param x_profile_id [String] Header param: Profile UUID to scope the request to a child profile. Only organiz
       #
       # @param request_options [Sentdm::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -161,11 +183,12 @@ module Sentdm
       # @see Sentdm::Models::TemplateDeleteParams
       def delete(id, params = {})
         parsed, options = Sentdm::TemplateDeleteParams.dump_request(params)
+        header_params = {x_profile_id: "x-profile-id"}
         @client.request(
           method: :delete,
           path: ["v3/templates/%1$s", id],
-          headers: {"content-type" => "*/*"},
-          body: parsed,
+          headers: parsed.slice(*header_params.keys).transform_keys(header_params),
+          body: parsed.except(*header_params.keys),
           model: NilClass,
           options: options
         )