@sentdm/sentdm 0.34.0 → 0.36.0

package/src/resources/profiles/profiles.ts

@@ -2,19 +2,15 @@
 
 import { APIResource } from '../../core/resource';
 import * as ProfilesAPI from './profiles';
-import * as WebhooksAPI from '../webhooks';
 import * as CampaignsAPI from './campaigns';
 import {
-  APIResponseOfBrandCampaign,
-  APIResponseOfListOfBrandCampaign,
-  BrandCampaign,
   CampaignCreateParams,
-  CampaignData,
+  CampaignCreateResponse,
   CampaignDeleteParams,
   CampaignListParams,
+  CampaignListResponse,
   CampaignUpdateParams,
-  CampaignUseCase,
-  CampaignUseCaseData,
+  CampaignUpdateResponse,
   Campaigns,
   MessagingUseCaseUs,
 } from './campaigns';
@@ -24,35 +20,37 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 /**
- * Manage organization profiles
+ * **Deprecated — use Sender Profiles.**
+ *
+ * The original profile resource, kept because it has live callers. It still works, and its replacement is `/v3/sender-profiles`, which takes the identity and the campaign in one call instead of across three.
+ *
+ * New integrations should not start here.
  */
 export class Profiles extends APIResource {
   campaigns: CampaignsAPI.Campaigns = new CampaignsAPI.Campaigns(this._client);
 
   /**
+   * **Deprecated.** This endpoint is replaced by `/v3/sender-profiles` and will be
+   * removed in a future release. It still behaves exactly as before, so nothing
+   * needs to change today — but new integrations should use `/v3/sender-profiles`,
+   * which models a profile's markets, compliance, brand, campaigns and billing
+   * explicitly.
+   *
    * Creates a new sender profile within an organization. Profiles represent
    * different brands, departments, or use cases, each with their own messaging
    * configuration and settings. Requires admin role in the organization.
    *
    * ## 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.
+   * Every profile owns its own WhatsApp Business Account — accounts are never shared
+   * between profiles or inherited from the organization. Provide a
+   * `whatsapp_business_account` object with `waba_id`, `phone_number_id`, and
+   * `access_token`. Obtain these from Meta Business Manager by creating a System
+   * User with `whatsapp_business_messaging` and `whatsapp_business_management`
+   * permissions.
    *
-   * **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.
+   * Omit the field and the profile is created without WhatsApp, staying incomplete
+   * until it has an account of its own.
    *
    * ## Brand
    *
@@ -67,13 +65,9 @@ export class Profiles extends APIResource {
    * and are forwarded directly to the payment processor. Providing `payment_details`
    * when `billing_model` is `"organization"` is not allowed.
    *
-   * @example
-   * ```ts
-   * const apiResponseOfProfileDetail =
-   *   await client.profiles.create();
-   * ```
+   * @deprecated
    */
-  create(params: ProfileCreateParams, options?: RequestOptions): APIPromise<APIResponseOfProfileDetail> {
+  create(params: ProfileCreateParams, options?: RequestOptions): APIPromise<ProfileCreateResponse> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.post('/v3/profiles', {
       body,
@@ -89,23 +83,23 @@ export class Profiles extends APIResource {
   }
 
   /**
+   * **Deprecated.** This endpoint is replaced by `/v3/sender-profiles` and will be
+   * removed in a future release. It still behaves exactly as before, so nothing
+   * needs to change today — but new integrations should use `/v3/sender-profiles`,
+   * which models a profile's markets, compliance, brand, campaigns and billing
+   * explicitly.
+   *
    * Retrieves detailed information about a specific sender profile within an
    * organization, including brand and KYC information if a brand has been
    * configured.
    *
-   * @example
-   * ```ts
-   * const apiResponseOfProfileDetail =
-   *   await client.profiles.retrieve(
-   *     '770e8400-e29b-41d4-a716-446655440002',
-   *   );
-   * ```
+   * @deprecated
    */
   retrieve(
     profileID: string,
     params: ProfileRetrieveParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<APIResponseOfProfileDetail> {
+  ): APIPromise<ProfileRetrieveResponse> {
     const { 'x-profile-id': xProfileID } = params ?? {};
     return this._client.get(path`/v3/profiles/${profileID}`, {
       ...options,
@@ -117,6 +111,12 @@ export class Profiles extends APIResource {
   }
 
   /**
+   * **Deprecated.** This endpoint is replaced by `/v3/sender-profiles` and will be
+   * removed in a future release. It still behaves exactly as before, so nothing
+   * needs to change today — but new integrations should use `/v3/sender-profiles`,
+   * which models a profile's markets, compliance, brand, campaigns and billing
+   * explicitly.
+   *
    * Updates a profile's configuration and settings. Requires admin role in the
    * organization. Only provided fields will be updated (partial update).
    *
@@ -136,19 +136,27 @@ export class Profiles extends APIResource {
    * and are forwarded directly to the payment processor. Providing `payment_details`
    * when `billing_model` is `"organization"` is not allowed.
    *
-   * @example
-   * ```ts
-   * const apiResponseOfProfileDetail =
-   *   await client.profiles.update(
-   *     '770e8400-e29b-41d4-a716-446655440002',
-   *   );
-   * ```
+   * ## Deprecated fields
+   *
+   * `sending_phone_number_profile_id` and `sending_whatsapp_number_profile_id` are
+   * **accepted and ignored**. Sender borrowing is gone: a profile cannot send from
+   * another profile's number, because two profiles behind one sender makes an
+   * inbound reply and a delivery receipt ambiguous about whose they are.
+   *
+   * Sending either **changes nothing and still returns `200`** — they are kept on
+   * the contract so an existing integration keeps working. Reads carry both keys too
+   * and always answer `null`, which is how you can confirm the value did not take.
+   *
+   * Give the profile a sender of its own instead — `POST /v3/channels/sms` or
+   * `POST /v3/channels/whatsapp`, sent with the `x-profile-id` header naming it.
+   *
+   * @deprecated
    */
   update(
     profileID: string,
     params: ProfileUpdateParams,
     options?: RequestOptions,
-  ): APIPromise<APIResponseOfProfileDetail> {
+  ): APIPromise<ProfileUpdateResponse> {
     const { 'Idempotency-Key': idempotencyKey, 'x-profile-id': xProfileID, ...body } = params;
     return this._client.patch(path`/v3/profiles/${profileID}`, {
       body,
@@ -164,15 +172,18 @@ export class Profiles extends APIResource {
   }
 
   /**
+   * **Deprecated.** This endpoint is replaced by `/v3/sender-profiles` and will be
+   * removed in a future release. It still behaves exactly as before, so nothing
+   * needs to change today — but new integrations should use `/v3/sender-profiles`,
+   * which models a profile's markets, compliance, brand, campaigns and billing
+   * explicitly.
+   *
    * 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.
    *
-   * @example
-   * ```ts
-   * const profiles = await client.profiles.list();
-   * ```
+   * @deprecated
    */
   list(
     params: ProfileListParams | null | undefined = {},
@@ -189,15 +200,19 @@ export class Profiles extends APIResource {
   }
 
   /**
+   * **Deprecated.** This endpoint is replaced by `/v3/sender-profiles` and will be
+   * removed in a future release. It still behaves exactly as before, so nothing
+   * needs to change today — but new integrations should use `/v3/sender-profiles`,
+   * which models a profile's markets, compliance, brand, campaigns and billing
+   * explicitly.
+   *
    * Soft deletes a sender profile. The profile will be marked as deleted but data is
-   * retained. Requires admin role in the organization.
+   * retained. Anything it still held is released first: phone numbers return to our
+   * inventory and can go to whoever asks next, its own WhatsApp account is
+   * deregistered, and its routing rules stop being used. Requires admin role in the
+   * organization.
    *
-   * @example
-   * ```ts
-   * await client.profiles.delete(
-   *   '770e8400-e29b-41d4-a716-446655440002',
-   * );
-   * ```
+   * @deprecated
    */
   delete(profileID: string, params: ProfileDeleteParams, options?: RequestOptions): APIPromise<void> {
     const { 'x-profile-id': xProfileID, ...body } = params;
@@ -212,15 +227,27 @@ export class Profiles extends APIResource {
   }
 
   /**
+   * **Deprecated.** This endpoint is replaced by `/v3/sender-profiles` and will be
+   * removed in a future release. It still behaves exactly as before, so nothing
+   * needs to change today — but new integrations should use `/v3/sender-profiles`,
+   * which models a profile's markets, compliance, brand, campaigns and billing
+   * explicitly.
+   *
    * Final step in the profile compliance workflow. Validates all prerequisites (KYC,
    * brand, campaigns, required documents), connects the profile to the SMS and
-   * WhatsApp channels, and sets its status based on configuration. Prerequisites are
-   * always validated first: if any fail the call returns 400. If they pass and the
-   * profile is already completed, the call returns 200 and does nothing. Otherwise
-   * it returns 202 and calls the provided webhook URL when background processing
-   * finishes.
+   * WhatsApp channels, and marks it onboarded. Prerequisites are always validated
+   * first: if any fail the call returns 400 naming every unmet one, and nothing is
+   * started. If they pass and the profile is already onboarded, the call returns 200
+   * and does nothing. Otherwise it returns 202 and calls the provided webhook URL
+   * when background processing finishes.
    *
-   * Prerequisites:
+   * Callable with the organization's API key or the profile's own key. The key's
+   * user must be an admin or owner of the profile, or of the organization it belongs
+   * to.
+   *
+   * Prerequisites (all but the last are checked before the already-onboarded
+   * short-circuit, matching the previous contract; the last is checked after it, so
+   * a profile that is already onboarded is never rejected by it):
    *
    * - Profile must have a name, short name, and description (short name max 50
    *   characters, description max 5000)
@@ -231,28 +258,20 @@ export class Profiles extends APIResource {
    * - TCR applications must have at least one campaign, own or inherited
    * - Destination countries marked as main must have their required compliance
    *   documents uploaded
+   * - TCR applications must state whether they inherit the organization's TCR brand
+   *   and campaign
    *
-   * Resulting status:
+   * Outcome:
    *
-   * - If either the SMS or WhatsApp channel is unconfigured, the profile is
-   *   SUBMITTED
-   * - For a TCR application that inherits both its brand and its campaigns, the
-   *   profile is COMPLETED
-   * - For a TCR application that owns either its brand or its campaigns, the profile
-   *   is COMPLETED once both have been submitted to TCR, and SUBMITTED until then
-   * - For a non-TCR application, the profile is SUBMITTED when a main destination
-   *   country is set, and COMPLETED otherwise
+   * - Once the prerequisites pass and background processing succeeds, the profile's
+   *   conversionFlowStatus becomes ONBOARDED and its public status reads `approved`
+   * - A profile with no WhatsApp channel, or one still awaiting TCR registration or
+   *   country documents, is onboarded like any other. Those are answered by the
+   *   brand and campaign records, not by a status on the profile
+   * - If background processing fails, the profile keeps the status it already had
+   *   and the webhook reports the reason
    *
-   * @example
-   * ```ts
-   * const response = await client.profiles.complete(
-   *   '660e8400-e29b-41d4-a716-446655440000',
-   *   {
-   *     webHookUrl:
-   *       'https://your-app.com/webhook/profile-complete',
-   *   },
-   * );
-   * ```
+   * @deprecated
    */
   complete(
     profileID: string,
@@ -274,24 +293,62 @@ export class Profiles extends APIResource {
   }
 }
 
+export interface DestinationCountry {
+  id?: string;
+
+  isMain?: boolean;
+}
+
+export type TcrBrandRelationship =
+  | 'BASIC_ACCOUNT'
+  | 'MEDIUM_ACCOUNT'
+  | 'LARGE_ACCOUNT'
+  | 'SMALL_ACCOUNT'
+  | 'KEY_ACCOUNT';
+
+export type TcrVertical =
+  | 'PROFESSIONAL'
+  | 'REAL_ESTATE'
+  | 'HEALTHCARE'
+  | 'HUMAN_RESOURCES'
+  | 'ENERGY'
+  | 'ENTERTAINMENT'
+  | 'RETAIL'
+  | 'TRANSPORTATION'
+  | 'AGRICULTURE'
+  | 'INSURANCE'
+  | 'POSTAL'
+  | 'EDUCATION'
+  | 'HOSPITALITY'
+  | 'FINANCIAL'
+  | 'POLITICAL'
+  | 'GAMBLING'
+  | 'LEGAL'
+  | 'CONSTRUCTION'
+  | 'NGO'
+  | 'MANUFACTURING'
+  | 'GOVERNMENT'
+  | 'TECHNOLOGY'
+  | 'COMMUNICATION';
+
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface APIResponseOfProfileDetail {
+export interface ProfileCreateResponse {
   /**
    * Detailed profile response for v3 API
    */
-  data?: ProfileDetail | null;
+  data?: ProfileCreateResponse.Data | null;
 
   /**
    * Error information
    */
-  error?: WebhooksAPI.ErrorDetail | null;
+  error?: ProfileCreateResponse.Error | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhooksAPI.APIMeta;
+  meta?: ProfileCreateResponse.Meta;
 
   /**
    * Indicates whether the request was successful
@@ -299,652 +356,907 @@ export interface APIResponseOfProfileDetail {
   success?: boolean;
 }
 
-/**
- * Billing contact information for a profile. Required when billing_model is
- * "profile" or "profile_and_organization".
- */
-export interface BillingContactInfo {
+export namespace ProfileCreateResponse {
   /**
-   * Email address where invoices will be sent (required)
+   * Detailed profile response for v3 API
    */
-  email: string;
+  export interface Data {
+    /**
+     * Profile unique identifier
+     */
+    id?: string;
 
-  /**
-   * Full name of the billing contact or company (required)
-   */
-  name: string;
+    /**
+     * @deprecated Always false. A profile no longer shares contacts with sibling
+     * profiles — it sees only what it owns. Retained so existing v3 clients reading
+     * allow_contact_sharing keep deserializing; it carries no information.
+     */
+    allow_contact_sharing?: boolean | null;
 
-  /**
-   * Billing address (optional). Free-form text including street, city, state, postal
-   * code, and country.
-   */
-  address?: string | null;
+    /**
+     * Whether number changes are allowed during onboarding
+     */
+    allow_number_change_during_onboarding?: boolean | null;
 
-  /**
-   * Phone number for the billing contact (optional)
-   */
-  phone?: string | null;
-}
+    /**
+     * @deprecated Always false. A profile no longer shares templates with sibling
+     * profiles. Retained so existing v3 clients reading allow_template_sharing keep
+     * deserializing; it carries no information.
+     */
+    allow_template_sharing?: boolean | null;
 
-/**
- * Business details and address for brand KYC
- */
-export interface BrandBusinessInfo {
-  /**
-   * City
-   */
-  city?: string | null;
+    /**
+     * Billing contact info returned in profile responses
+     */
+    billing_contact?: Data.BillingContact | null;
 
-  /**
-   * Country code (e.g., US, CA)
-   */
-  country?: string | null;
+    /**
+     * Billing model: profile, organization, or profile_and_organization
+     */
+    billing_model?: string;
 
-  /**
-   * Country where the business is registered
-   */
-  countryOfRegistration?: string | null;
+    /**
+     * Brand response with nested contact, business, and compliance sections — mirrors
+     * the request structure.
+     */
+    brand?: Data.Brand | null;
 
-  entityType?: 'PRIVATE_PROFIT' | 'PUBLIC_PROFIT' | 'NON_PROFIT' | 'SOLE_PROPRIETOR' | 'GOVERNMENT' | null;
+    /**
+     * When the profile was created
+     */
+    created_at?: string;
 
-  /**
-   * Legal business name
-   */
-  legalName?: string | null;
+    /**
+     * Profile description
+     */
+    description?: string | null;
 
-  /**
-   * Postal/ZIP code
-   */
-  postalCode?: string | null;
+    /**
+     * Profile email (inherited from organization)
+     */
+    email?: string | null;
 
-  /**
-   * State/province code
-   */
-  state?: string | null;
+    /**
+     * Profile icon URL
+     */
+    icon?: string | null;
 
-  /**
-   * Street address
-   */
-  street?: string | null;
+    /**
+     * @deprecated Always false. A profile no longer inherits its organization's
+     * contacts. Retained so existing v3 clients reading inherit_contacts keep
+     * deserializing; it carries no information.
+     */
+    inherit_contacts?: boolean | null;
 
-  /**
-   * Tax ID/EIN number
-   */
-  taxId?: string | null;
+    /**
+     * Whether this profile inherits TCR brand from the organization
+     */
+    inherit_tcr_brand?: boolean;
 
-  /**
-   * Type of tax ID (e.g., us_ein, ca_bn)
-   */
-  taxIdType?: string | null;
+    /**
+     * Whether this profile inherits TCR campaign from the organization
+     */
+    inherit_tcr_campaign?: boolean;
 
-  /**
-   * Business website URL
-   */
-  url?: string | null;
-}
+    /**
+     * @deprecated Always false. A profile no longer inherits its organization's
+     * templates. Retained so existing v3 clients reading inherit_templates keep
+     * deserializing; it carries no information.
+     */
+    inherit_templates?: boolean | null;
 
-/**
- * Compliance and TCR information for brand registration
- */
-export interface BrandComplianceInfo {
-  brandRelationship: TcrBrandRelationship;
+    /**
+     * Profile name
+     */
+    name?: string;
 
-  vertical: TcrVertical;
+    /**
+     * Parent organization ID
+     */
+    organization_id?: string | null;
 
-  /**
-   * List of destination countries for messaging
-   */
-  destinationCountries?: Array<DestinationCountry> | null;
+    /**
+     * Direct SMS phone number
+     */
+    sending_phone_number?: string | null;
 
-  /**
-   * Whether this is a TCR (Campaign Registry) application
-   */
-  isTcrApplication?: boolean | null;
+    /**
+     * @deprecated Deprecated. Always null. Sender borrowing is gone: a profile no
+     * longer points at another profile for its SMS sender, and every profile owns the
+     * sender it sends from.
+     *
+     * Kept on the wire, and never populated, because those are two different promises.
+     * Removing the key changes the response's shape — a generated client loses the
+     * property and stops compiling on the next regenerate, for a value that is now
+     * null for every profile in existence. Keeping it null costs a key and breaks
+     * nobody, and null is the honest answer rather than a placeholder: there is no
+     * borrowing left to report.
+     *
+     * Nothing could populate it. Migration 260813161500 dropped the column and copied
+     * each borrower its own channel-provider row; its Down() says outright that the
+     * borrower-to-lender pairing is not recoverable. The only surviving trace is a
+     * notes string on the copied row.
+     */
+    sending_phone_number_profile_id?: string | null;
 
-  /**
-   * Additional notes about the business or use case
-   */
-  notes?: string | null;
+    /**
+     * @deprecated
+     */
+    sending_whatsapp_number_profile_id?: string | null;
 
-  /**
-   * Phone number prefix for messaging (e.g., "+1")
-   */
-  phoneNumberPrefix?: string | null;
+    /**
+     * Profile short name/abbreviation. 3–11 characters: letters, numbers, and spaces
+     * only, with at least one letter.
+     */
+    short_name?: string | null;
 
-  /**
-   * Primary messaging use case description
-   */
-  primaryUseCase?: string | null;
-}
+    /**
+     * Profile setup status: incomplete, pending_review, approved, rejected
+     */
+    status?: string;
 
-/**
- * Contact information for brand KYC
- */
-export interface BrandContactInfo {
-  /**
-   * Primary contact name (required)
-   */
-  name: string;
+    /**
+     * When the profile was last updated
+     */
+    updated_at?: string | null;
 
-  /**
-   * Business/brand name
-   */
-  businessName?: string | null;
+    /**
+     * WhatsApp Business Account ID associated with this profile. Present whether the
+     * WABA is inherited from the organization or configured directly.
+     */
+    waba_id?: string | null;
 
-  /**
-   * Contact email address
-   */
-  email?: string | null;
+    /**
+     * Direct WhatsApp phone number
+     */
+    whatsapp_phone_number?: string | null;
+  }
 
-  /**
-   * Contact phone number in E.164 format
-   */
-  phone?: string | null;
+  export namespace Data {
+    /**
+     * Billing contact info returned in profile responses
+     */
+    export interface BillingContact {
+      address?: string | null;
 
-  /**
-   * Contact phone country code (e.g., "1" for US)
-   */
-  phoneCountryCode?: string | null;
+      email?: string | null;
 
-  /**
-   * Contact's role in the business
-   */
-  role?: string | null;
-}
+      name?: string | null;
 
-/**
- * Brand and KYC data grouped into contact, business, and compliance sections
- */
-export interface BrandsBrandData {
-  /**
-   * Compliance and TCR information for brand registration
-   */
-  compliance: BrandComplianceInfo;
+      phone?: string | null;
+    }
 
-  /**
-   * Contact information for brand KYC
-   */
-  contact: BrandContactInfo;
+    /**
+     * Brand response with nested contact, business, and compliance sections — mirrors
+     * the request structure.
+     */
+    export interface Brand {
+      /**
+       * Unique identifier for the brand
+       */
+      id?: string;
 
-  /**
-   * Business details and address for brand KYC
-   */
-  business?: BrandBusinessInfo | null;
-}
+      /**
+       * Business details and address information
+       */
+      business?: Brand.Business | null;
 
-export interface DestinationCountry {
-  id?: string;
+      /**
+       * Compliance and TCR-related information
+       */
+      compliance?: Brand.Compliance | null;
 
-  isMain?: boolean;
-}
+      /**
+       * Contact information for the brand
+       */
+      contact?: Brand.Contact | null;
 
-/**
- * Payment card details for a profile. Accepted when billing_model is "profile" or
- * "profile_and_organization". These details are not stored on our servers and will
- * be forwarded to the payment processor.
- */
-export interface PaymentDetails {
-  /**
-   * Card number (digits only, 13–19 characters)
-   */
-  card_number: string;
+      /**
+       * When the brand was created
+       */
+      created_at?: string;
 
-  /**
-   * Card security code (3–4 digits)
-   */
-  cvc: string;
+      /**
+       * @deprecated Deprecated and scheduled for removal. Identifies the Campaign
+       * Service Provider that registered the brand, which is Sent, so the value is the
+       * same for every brand and every account. Nothing on your side can act on it and
+       * there is no replacement. Stop reading it.
+       */
+      csp_id?: string | null;
 
-  /**
-   * Card expiry date in MM/YY format (e.g. "09/27")
-   */
-  expiry: string;
+      identity_status?: 'SELF_DECLARED' | 'UNVERIFIED' | 'VERIFIED' | 'VETTED_VERIFIED' | null;
 
-  /**
-   * Billing ZIP / postal code associated with the card
-   */
-  zip_code: string;
-}
+      /**
+       * Whether this brand is inherited from the parent organization
+       */
+      is_inherited?: boolean;
 
-/**
- * Detailed profile response for v3 API
- */
-export interface ProfileDetail {
-  /**
-   * Profile unique identifier
-   */
-  id?: string;
+      status?: 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | null;
 
-  /**
-   * Whether contacts are shared across profiles in the organization
-   */
-  allow_contact_sharing?: boolean;
+      /**
+       * When the brand was submitted to TCR
+       */
+      submitted_at?: string | null;
 
-  /**
-   * Whether number changes are allowed during onboarding
-   */
-  allow_number_change_during_onboarding?: boolean | null;
+      /**
+       * Whether this brand has been submitted to TCR
+       */
+      submitted_to_tcr?: boolean;
 
-  /**
-   * Whether templates are shared across profiles in the organization
-   */
-  allow_template_sharing?: boolean;
+      /**
+       * TCR brand ID (populated after TCR submission)
+       */
+      tcr_brand_id?: string | null;
 
-  /**
-   * Billing contact info returned in profile responses
-   */
-  billing_contact?: ProfileDetail.BillingContact | null;
+      /**
+       * Universal EIN from TCR
+       */
+      universal_ein?: string | null;
 
-  /**
-   * Billing model: profile, organization, or profile_and_organization
-   */
-  billing_model?: string;
+      /**
+       * When the brand was last updated
+       */
+      updated_at?: string | null;
+    }
 
-  /**
-   * Brand response with nested contact, business, and compliance sections — mirrors
-   * the request structure.
-   */
-  brand?: ProfileDetail.Brand | null;
+    export namespace Brand {
+      /**
+       * Business details and address information
+       */
+      export interface Business {
+        /**
+         * City
+         */
+        city?: string | null;
+
+        /**
+         * Country code (e.g., US, CA)
+         */
+        country?: string | null;
+
+        /**
+         * Country where the business is registered
+         */
+        country_of_registration?: string | null;
+
+        /**
+         * Business entity type
+         */
+        entity_type?: string | null;
+
+        /**
+         * Legal business name
+         */
+        legal_name?: string | null;
+
+        /**
+         * Postal/ZIP code
+         */
+        postal_code?: string | null;
+
+        /**
+         * State/province code
+         */
+        state?: string | null;
+
+        /**
+         * Street address
+         */
+        street?: string | null;
+
+        /**
+         * Tax ID/EIN number
+         */
+        tax_id?: string | null;
+
+        /**
+         * Type of tax ID (e.g., us_ein, ca_bn)
+         */
+        tax_id_type?: string | null;
+
+        /**
+         * Business website URL
+         */
+        url?: string | null;
+      }
 
-  /**
-   * When the profile was created
-   */
-  created_at?: string;
+      /**
+       * Compliance and TCR-related information
+       */
+      export interface Compliance {
+        brand_relationship?: ProfilesAPI.TcrBrandRelationship | null;
+
+        /**
+         * List of destination countries for messaging
+         */
+        destination_countries?: Array<ProfilesAPI.DestinationCountry>;
+
+        /**
+         * Whether this is a TCR (Campaign Registry) application
+         */
+        is_tcr_application?: boolean;
+
+        /**
+         * Additional notes about the business or use case
+         */
+        notes?: string | null;
+
+        /**
+         * Phone number prefix for messaging (e.g., "+1")
+         */
+        phone_number_prefix?: string | null;
+
+        /**
+         * @deprecated Always null. The brand's free-text primary use case is no longer
+         * stored: it reached neither TCR nor any decision, and its column is dropped with
+         * no backfill, because the values were prose and the typed equivalent is the
+         * campaign's MessagingUseCaseUS.
+         *
+         * Retained so existing v3 clients reading primary_use_case keep deserializing.
+         * Unlike the profile sharing flags, which can answer false truthfully, there is no
+         * value to report here — the field is present and empty rather than present and
+         * wrong.
+         */
+        primary_use_case?: string | null;
+
+        vertical?: ProfilesAPI.TcrVertical | null;
+      }
 
-  /**
-   * Profile description
-   */
-  description?: string | null;
+      /**
+       * Contact information for the brand
+       */
+      export interface Contact {
+        /**
+         * Business/brand name
+         */
+        business_name?: string | null;
+
+        /**
+         * Contact email address
+         */
+        email?: string | null;
+
+        /**
+         * Primary contact name
+         */
+        name?: string;
+
+        /**
+         * Contact phone number in E.164 format
+         */
+        phone?: string | null;
+
+        /**
+         * Contact phone country code (e.g., "1" for US)
+         */
+        phone_country_code?: string | null;
+
+        /**
+         * Contact's role in the business
+         */
+        role?: string | null;
+      }
+    }
+  }
 
   /**
-   * Profile email (inherited from organization)
+   * Error information
    */
-  email?: string | null;
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
 
-  /**
-   * Profile icon URL
-   */
-  icon?: string | null;
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
 
-  /**
-   * Whether this profile inherits contacts from the organization
-   */
-  inherit_contacts?: boolean;
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
 
-  /**
-   * Whether this profile inherits TCR brand from the organization
-   */
-  inherit_tcr_brand?: boolean;
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
 
   /**
-   * Whether this profile inherits TCR campaign from the organization
+   * Request and response metadata
    */
-  inherit_tcr_campaign?: boolean;
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
 
-  /**
-   * Whether this profile inherits templates from the organization
-   */
-  inherit_templates?: boolean;
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
 
-  /**
-   * Profile name
-   */
-  name?: string;
+    /**
+     * API version used for this request
+     */
+    version?: string;
+  }
+}
 
+/**
+ * Standard API response envelope for all v3 endpoints
+ */
+export interface ProfileRetrieveResponse {
   /**
-   * Parent organization ID
+   * Detailed profile response for v3 API
    */
-  organization_id?: string | null;
+  data?: ProfileRetrieveResponse.Data | null;
 
   /**
-   * Direct SMS phone number
+   * Error information
    */
-  sending_phone_number?: string | null;
+  error?: ProfileRetrieveResponse.Error | null;
 
   /**
-   * Reference to another profile whose SMS configuration this profile uses
+   * Request and response metadata
    */
-  sending_phone_number_profile_id?: string | null;
+  meta?: ProfileRetrieveResponse.Meta;
 
   /**
-   * Reference to another profile for WhatsApp configuration
+   * Indicates whether the request was successful
    */
-  sending_whatsapp_number_profile_id?: string | null;
+  success?: boolean;
+}
 
+export namespace ProfileRetrieveResponse {
   /**
-   * Profile short name/abbreviation. 3–11 characters: letters, numbers, and spaces
-   * only, with at least one letter.
+   * Detailed profile response for v3 API
    */
-  short_name?: string | null;
+  export interface Data {
+    /**
+     * Profile unique identifier
+     */
+    id?: string;
 
-  /**
-   * Profile setup status: incomplete, pending_review, approved, rejected
-   */
-  status?: string;
+    /**
+     * @deprecated Always false. A profile no longer shares contacts with sibling
+     * profiles — it sees only what it owns. Retained so existing v3 clients reading
+     * allow_contact_sharing keep deserializing; it carries no information.
+     */
+    allow_contact_sharing?: boolean | null;
 
-  /**
-   * When the profile was last updated
-   */
-  updated_at?: string | null;
+    /**
+     * Whether number changes are allowed during onboarding
+     */
+    allow_number_change_during_onboarding?: boolean | null;
 
-  /**
-   * WhatsApp Business Account ID associated with this profile. Present whether the
-   * WABA is inherited from the organization or configured directly.
-   */
-  waba_id?: string | null;
+    /**
+     * @deprecated Always false. A profile no longer shares templates with sibling
+     * profiles. Retained so existing v3 clients reading allow_template_sharing keep
+     * deserializing; it carries no information.
+     */
+    allow_template_sharing?: boolean | null;
 
-  /**
-   * Direct WhatsApp phone number
-   */
-  whatsapp_phone_number?: string | null;
-}
+    /**
+     * Billing contact info returned in profile responses
+     */
+    billing_contact?: Data.BillingContact | null;
 
-export namespace ProfileDetail {
-  /**
-   * Billing contact info returned in profile responses
-   */
-  export interface BillingContact {
-    address?: string | null;
+    /**
+     * Billing model: profile, organization, or profile_and_organization
+     */
+    billing_model?: string;
 
-    email?: string | null;
+    /**
+     * Brand response with nested contact, business, and compliance sections — mirrors
+     * the request structure.
+     */
+    brand?: Data.Brand | null;
 
-    name?: string | null;
+    /**
+     * When the profile was created
+     */
+    created_at?: string;
 
-    phone?: string | null;
-  }
+    /**
+     * Profile description
+     */
+    description?: string | null;
 
-  /**
-   * Brand response with nested contact, business, and compliance sections — mirrors
-   * the request structure.
-   */
-  export interface Brand {
     /**
-     * Unique identifier for the brand
+     * Profile email (inherited from organization)
      */
-    id?: string;
+    email?: string | null;
 
     /**
-     * Business details and address information
+     * Profile icon URL
      */
-    business?: Brand.Business | null;
+    icon?: string | null;
 
     /**
-     * Compliance and TCR-related information
+     * @deprecated Always false. A profile no longer inherits its organization's
+     * contacts. Retained so existing v3 clients reading inherit_contacts keep
+     * deserializing; it carries no information.
      */
-    compliance?: Brand.Compliance | null;
+    inherit_contacts?: boolean | null;
 
     /**
-     * Contact information for the brand
+     * Whether this profile inherits TCR brand from the organization
      */
-    contact?: Brand.Contact | null;
+    inherit_tcr_brand?: boolean;
 
     /**
-     * When the brand was created
+     * Whether this profile inherits TCR campaign from the organization
      */
-    created_at?: string;
+    inherit_tcr_campaign?: boolean;
 
     /**
-     * @deprecated Deprecated and scheduled for removal. Identifies the Campaign
-     * Service Provider that registered the brand, which is Sent, so the value is the
-     * same for every brand and every account. Nothing on your side can act on it and
-     * there is no replacement. Stop reading it.
+     * @deprecated Always false. A profile no longer inherits its organization's
+     * templates. Retained so existing v3 clients reading inherit_templates keep
+     * deserializing; it carries no information.
      */
-    csp_id?: string | null;
+    inherit_templates?: boolean | null;
 
-    identity_status?: 'SELF_DECLARED' | 'UNVERIFIED' | 'VERIFIED' | 'VETTED_VERIFIED' | null;
+    /**
+     * Profile name
+     */
+    name?: string;
 
     /**
-     * Whether this brand is inherited from the parent organization
+     * Parent organization ID
      */
-    is_inherited?: boolean;
+    organization_id?: string | null;
 
-    status?: 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | null;
+    /**
+     * Direct SMS phone number
+     */
+    sending_phone_number?: string | null;
 
     /**
-     * When the brand was submitted to TCR
+     * @deprecated Deprecated. Always null. Sender borrowing is gone: a profile no
+     * longer points at another profile for its SMS sender, and every profile owns the
+     * sender it sends from.
+     *
+     * Kept on the wire, and never populated, because those are two different promises.
+     * Removing the key changes the response's shape — a generated client loses the
+     * property and stops compiling on the next regenerate, for a value that is now
+     * null for every profile in existence. Keeping it null costs a key and breaks
+     * nobody, and null is the honest answer rather than a placeholder: there is no
+     * borrowing left to report.
+     *
+     * Nothing could populate it. Migration 260813161500 dropped the column and copied
+     * each borrower its own channel-provider row; its Down() says outright that the
+     * borrower-to-lender pairing is not recoverable. The only surviving trace is a
+     * notes string on the copied row.
      */
-    submitted_at?: string | null;
+    sending_phone_number_profile_id?: string | null;
 
     /**
-     * Whether this brand has been submitted to TCR
+     * @deprecated
      */
-    submitted_to_tcr?: boolean;
+    sending_whatsapp_number_profile_id?: string | null;
 
     /**
-     * TCR brand ID (populated after TCR submission)
+     * Profile short name/abbreviation. 3–11 characters: letters, numbers, and spaces
+     * only, with at least one letter.
      */
-    tcr_brand_id?: string | null;
+    short_name?: string | null;
 
     /**
-     * Universal EIN from TCR
+     * Profile setup status: incomplete, pending_review, approved, rejected
      */
-    universal_ein?: string | null;
+    status?: string;
 
     /**
-     * When the brand was last updated
+     * When the profile was last updated
      */
     updated_at?: string | null;
-  }
 
-  export namespace Brand {
     /**
-     * Business details and address information
+     * WhatsApp Business Account ID associated with this profile. Present whether the
+     * WABA is inherited from the organization or configured directly.
      */
-    export interface Business {
-      /**
-       * City
-       */
-      city?: string | null;
+    waba_id?: string | null;
 
-      /**
-       * Country code (e.g., US, CA)
-       */
-      country?: string | null;
+    /**
+     * Direct WhatsApp phone number
+     */
+    whatsapp_phone_number?: string | null;
+  }
 
-      /**
-       * Country where the business is registered
-       */
-      country_of_registration?: string | null;
+  export namespace Data {
+    /**
+     * Billing contact info returned in profile responses
+     */
+    export interface BillingContact {
+      address?: string | null;
 
-      /**
-       * Business entity type
-       */
-      entity_type?: string | null;
+      email?: string | null;
 
-      /**
-       * Legal business name
-       */
-      legal_name?: string | null;
+      name?: string | null;
 
-      /**
-       * Postal/ZIP code
-       */
-      postal_code?: string | null;
+      phone?: string | null;
+    }
 
+    /**
+     * Brand response with nested contact, business, and compliance sections — mirrors
+     * the request structure.
+     */
+    export interface Brand {
       /**
-       * State/province code
+       * Unique identifier for the brand
        */
-      state?: string | null;
+      id?: string;
 
       /**
-       * Street address
+       * Business details and address information
        */
-      street?: string | null;
+      business?: Brand.Business | null;
 
       /**
-       * Tax ID/EIN number
+       * Compliance and TCR-related information
        */
-      tax_id?: string | null;
+      compliance?: Brand.Compliance | null;
 
       /**
-       * Type of tax ID (e.g., us_ein, ca_bn)
+       * Contact information for the brand
        */
-      tax_id_type?: string | null;
+      contact?: Brand.Contact | null;
 
       /**
-       * Business website URL
+       * When the brand was created
        */
-      url?: string | null;
-    }
-
-    /**
-     * Compliance and TCR-related information
-     */
-    export interface Compliance {
-      brand_relationship?: ProfilesAPI.TcrBrandRelationship | null;
+      created_at?: string;
 
       /**
-       * List of destination countries for messaging
+       * @deprecated Deprecated and scheduled for removal. Identifies the Campaign
+       * Service Provider that registered the brand, which is Sent, so the value is the
+       * same for every brand and every account. Nothing on your side can act on it and
+       * there is no replacement. Stop reading it.
        */
-      destination_countries?: Array<ProfilesAPI.DestinationCountry>;
+      csp_id?: string | null;
 
-      /**
-       * Whether this is a TCR (Campaign Registry) application
-       */
-      is_tcr_application?: boolean;
+      identity_status?: 'SELF_DECLARED' | 'UNVERIFIED' | 'VERIFIED' | 'VETTED_VERIFIED' | null;
 
       /**
-       * Additional notes about the business or use case
+       * Whether this brand is inherited from the parent organization
        */
-      notes?: string | null;
+      is_inherited?: boolean;
+
+      status?: 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | null;
 
       /**
-       * Phone number prefix for messaging (e.g., "+1")
+       * When the brand was submitted to TCR
        */
-      phone_number_prefix?: string | null;
+      submitted_at?: string | null;
 
       /**
-       * Primary messaging use case description
+       * Whether this brand has been submitted to TCR
        */
-      primary_use_case?: string | null;
-
-      vertical?: ProfilesAPI.TcrVertical | null;
-    }
+      submitted_to_tcr?: boolean;
 
-    /**
-     * Contact information for the brand
-     */
-    export interface Contact {
       /**
-       * Business/brand name
+       * TCR brand ID (populated after TCR submission)
        */
-      business_name?: string | null;
+      tcr_brand_id?: string | null;
 
       /**
-       * Contact email address
+       * Universal EIN from TCR
        */
-      email?: string | null;
+      universal_ein?: string | null;
 
       /**
-       * Primary contact name
+       * When the brand was last updated
        */
-      name?: string;
+      updated_at?: string | null;
+    }
 
+    export namespace Brand {
       /**
-       * Contact phone number in E.164 format
+       * Business details and address information
        */
-      phone?: string | null;
+      export interface Business {
+        /**
+         * City
+         */
+        city?: string | null;
+
+        /**
+         * Country code (e.g., US, CA)
+         */
+        country?: string | null;
+
+        /**
+         * Country where the business is registered
+         */
+        country_of_registration?: string | null;
+
+        /**
+         * Business entity type
+         */
+        entity_type?: string | null;
+
+        /**
+         * Legal business name
+         */
+        legal_name?: string | null;
+
+        /**
+         * Postal/ZIP code
+         */
+        postal_code?: string | null;
+
+        /**
+         * State/province code
+         */
+        state?: string | null;
+
+        /**
+         * Street address
+         */
+        street?: string | null;
+
+        /**
+         * Tax ID/EIN number
+         */
+        tax_id?: string | null;
+
+        /**
+         * Type of tax ID (e.g., us_ein, ca_bn)
+         */
+        tax_id_type?: string | null;
+
+        /**
+         * Business website URL
+         */
+        url?: string | null;
+      }
 
       /**
-       * Contact phone country code (e.g., "1" for US)
+       * Compliance and TCR-related information
        */
-      phone_country_code?: string | null;
+      export interface Compliance {
+        brand_relationship?: ProfilesAPI.TcrBrandRelationship | null;
+
+        /**
+         * List of destination countries for messaging
+         */
+        destination_countries?: Array<ProfilesAPI.DestinationCountry>;
+
+        /**
+         * Whether this is a TCR (Campaign Registry) application
+         */
+        is_tcr_application?: boolean;
+
+        /**
+         * Additional notes about the business or use case
+         */
+        notes?: string | null;
+
+        /**
+         * Phone number prefix for messaging (e.g., "+1")
+         */
+        phone_number_prefix?: string | null;
+
+        /**
+         * @deprecated Always null. The brand's free-text primary use case is no longer
+         * stored: it reached neither TCR nor any decision, and its column is dropped with
+         * no backfill, because the values were prose and the typed equivalent is the
+         * campaign's MessagingUseCaseUS.
+         *
+         * Retained so existing v3 clients reading primary_use_case keep deserializing.
+         * Unlike the profile sharing flags, which can answer false truthfully, there is no
+         * value to report here — the field is present and empty rather than present and
+         * wrong.
+         */
+        primary_use_case?: string | null;
+
+        vertical?: ProfilesAPI.TcrVertical | null;
+      }
 
       /**
-       * Contact's role in the business
+       * Contact information for the brand
        */
-      role?: string | null;
+      export interface Contact {
+        /**
+         * Business/brand name
+         */
+        business_name?: string | null;
+
+        /**
+         * Contact email address
+         */
+        email?: string | null;
+
+        /**
+         * Primary contact name
+         */
+        name?: string;
+
+        /**
+         * Contact phone number in E.164 format
+         */
+        phone?: string | null;
+
+        /**
+         * Contact phone country code (e.g., "1" for US)
+         */
+        phone_country_code?: string | null;
+
+        /**
+         * Contact's role in the business
+         */
+        role?: string | null;
+      }
     }
   }
-}
-
-export type TcrBrandRelationship =
-  | 'BASIC_ACCOUNT'
-  | 'MEDIUM_ACCOUNT'
-  | 'LARGE_ACCOUNT'
-  | 'SMALL_ACCOUNT'
-  | 'KEY_ACCOUNT';
-
-export type TcrVertical =
-  | 'PROFESSIONAL'
-  | 'REAL_ESTATE'
-  | 'HEALTHCARE'
-  | 'HUMAN_RESOURCES'
-  | 'ENERGY'
-  | 'ENTERTAINMENT'
-  | 'RETAIL'
-  | 'TRANSPORTATION'
-  | 'AGRICULTURE'
-  | 'INSURANCE'
-  | 'POSTAL'
-  | 'EDUCATION'
-  | 'HOSPITALITY'
-  | 'FINANCIAL'
-  | 'POLITICAL'
-  | 'GAMBLING'
-  | 'LEGAL'
-  | 'CONSTRUCTION'
-  | 'NGO'
-  | 'MANUFACTURING'
-  | 'GOVERNMENT'
-  | 'TECHNOLOGY'
-  | 'COMMUNICATION';
-
-/**
- * Standard API response envelope for all v3 endpoints
- */
-export interface ProfileListResponse {
-  /**
-   * List of profiles response
-   */
-  data?: ProfileListResponse.Data | null;
 
   /**
    * Error information
    */
-  error?: WebhooksAPI.ErrorDetail | null;
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
+
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
+
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
+
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
 
   /**
    * Request and response metadata
    */
-  meta?: WebhooksAPI.APIMeta;
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
 
-  /**
-   * Indicates whether the request was successful
-   */
-  success?: boolean;
-}
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
 
-export namespace ProfileListResponse {
-  /**
-   * List of profiles response
-   */
-  export interface Data {
     /**
-     * List of profiles in the organization
+     * API version used for this request
      */
-    profiles?: Array<ProfilesAPI.ProfileDetail>;
+    version?: string;
   }
 }
 
 /**
  * Standard API response envelope for all v3 endpoints
  */
-export interface ProfileCompleteResponse {
+export interface ProfileUpdateResponse {
   /**
-   * Response when a profile is already in the completed state and no further action
-   * is taken.
+   * Detailed profile response for v3 API
    */
-  data?: ProfileCompleteResponse.Data | null;
+  data?: ProfileUpdateResponse.Data | null;
 
   /**
    * Error information
    */
-  error?: WebhooksAPI.ErrorDetail | null;
+  error?: ProfileUpdateResponse.Error | null;
 
   /**
    * Request and response metadata
    */
-  meta?: WebhooksAPI.APIMeta;
+  meta?: ProfileUpdateResponse.Meta;
 
   /**
    * Indicates whether the request was successful
@@ -952,41 +1264,1079 @@ export interface ProfileCompleteResponse {
   success?: boolean;
 }
 
-export namespace ProfileCompleteResponse {
+export namespace ProfileUpdateResponse {
   /**
-   * Response when a profile is already in the completed state and no further action
-   * is taken.
+   * Detailed profile response for v3 API
    */
   export interface Data {
     /**
-     * Human-readable message describing the result.
+     * Profile unique identifier
      */
-    message?: string;
+    id?: string;
 
     /**
-     * Current process status of the profile (e.g., "completed", "submitted",
-     * "in_progress").
+     * @deprecated Always false. A profile no longer shares contacts with sibling
+     * profiles — it sees only what it owns. Retained so existing v3 clients reading
+     * allow_contact_sharing keep deserializing; it carries no information.
      */
-    status?: string;
-  }
-}
+    allow_contact_sharing?: boolean | null;
 
-export interface ProfileCreateParams {
-  /**
-   * Body param: Whether contacts are shared across profiles (default: false)
-   */
-  allow_contact_sharing?: boolean;
-
-  /**
-   * Body param: Whether templates are shared across profiles (default: false)
-   */
-  allow_template_sharing?: boolean;
+    /**
+     * Whether number changes are allowed during onboarding
+     */
+    allow_number_change_during_onboarding?: boolean | null;
+
+    /**
+     * @deprecated Always false. A profile no longer shares templates with sibling
+     * profiles. Retained so existing v3 clients reading allow_template_sharing keep
+     * deserializing; it carries no information.
+     */
+    allow_template_sharing?: boolean | null;
+
+    /**
+     * Billing contact info returned in profile responses
+     */
+    billing_contact?: Data.BillingContact | null;
+
+    /**
+     * Billing model: profile, organization, or profile_and_organization
+     */
+    billing_model?: string;
+
+    /**
+     * Brand response with nested contact, business, and compliance sections — mirrors
+     * the request structure.
+     */
+    brand?: Data.Brand | null;
+
+    /**
+     * When the profile was created
+     */
+    created_at?: string;
+
+    /**
+     * Profile description
+     */
+    description?: string | null;
+
+    /**
+     * Profile email (inherited from organization)
+     */
+    email?: string | null;
+
+    /**
+     * Profile icon URL
+     */
+    icon?: string | null;
+
+    /**
+     * @deprecated Always false. A profile no longer inherits its organization's
+     * contacts. Retained so existing v3 clients reading inherit_contacts keep
+     * deserializing; it carries no information.
+     */
+    inherit_contacts?: boolean | null;
+
+    /**
+     * Whether this profile inherits TCR brand from the organization
+     */
+    inherit_tcr_brand?: boolean;
+
+    /**
+     * Whether this profile inherits TCR campaign from the organization
+     */
+    inherit_tcr_campaign?: boolean;
+
+    /**
+     * @deprecated Always false. A profile no longer inherits its organization's
+     * templates. Retained so existing v3 clients reading inherit_templates keep
+     * deserializing; it carries no information.
+     */
+    inherit_templates?: boolean | null;
+
+    /**
+     * Profile name
+     */
+    name?: string;
+
+    /**
+     * Parent organization ID
+     */
+    organization_id?: string | null;
+
+    /**
+     * Direct SMS phone number
+     */
+    sending_phone_number?: string | null;
+
+    /**
+     * @deprecated Deprecated. Always null. Sender borrowing is gone: a profile no
+     * longer points at another profile for its SMS sender, and every profile owns the
+     * sender it sends from.
+     *
+     * Kept on the wire, and never populated, because those are two different promises.
+     * Removing the key changes the response's shape — a generated client loses the
+     * property and stops compiling on the next regenerate, for a value that is now
+     * null for every profile in existence. Keeping it null costs a key and breaks
+     * nobody, and null is the honest answer rather than a placeholder: there is no
+     * borrowing left to report.
+     *
+     * Nothing could populate it. Migration 260813161500 dropped the column and copied
+     * each borrower its own channel-provider row; its Down() says outright that the
+     * borrower-to-lender pairing is not recoverable. The only surviving trace is a
+     * notes string on the copied row.
+     */
+    sending_phone_number_profile_id?: string | null;
+
+    /**
+     * @deprecated
+     */
+    sending_whatsapp_number_profile_id?: string | null;
+
+    /**
+     * Profile short name/abbreviation. 3–11 characters: letters, numbers, and spaces
+     * only, with at least one letter.
+     */
+    short_name?: string | null;
+
+    /**
+     * Profile setup status: incomplete, pending_review, approved, rejected
+     */
+    status?: string;
+
+    /**
+     * When the profile was last updated
+     */
+    updated_at?: string | null;
+
+    /**
+     * WhatsApp Business Account ID associated with this profile. Present whether the
+     * WABA is inherited from the organization or configured directly.
+     */
+    waba_id?: string | null;
+
+    /**
+     * Direct WhatsApp phone number
+     */
+    whatsapp_phone_number?: string | null;
+  }
+
+  export namespace Data {
+    /**
+     * Billing contact info returned in profile responses
+     */
+    export interface BillingContact {
+      address?: string | null;
+
+      email?: string | null;
+
+      name?: string | null;
+
+      phone?: string | null;
+    }
+
+    /**
+     * Brand response with nested contact, business, and compliance sections — mirrors
+     * the request structure.
+     */
+    export interface Brand {
+      /**
+       * Unique identifier for the brand
+       */
+      id?: string;
+
+      /**
+       * Business details and address information
+       */
+      business?: Brand.Business | null;
+
+      /**
+       * Compliance and TCR-related information
+       */
+      compliance?: Brand.Compliance | null;
+
+      /**
+       * Contact information for the brand
+       */
+      contact?: Brand.Contact | null;
+
+      /**
+       * When the brand was created
+       */
+      created_at?: string;
+
+      /**
+       * @deprecated Deprecated and scheduled for removal. Identifies the Campaign
+       * Service Provider that registered the brand, which is Sent, so the value is the
+       * same for every brand and every account. Nothing on your side can act on it and
+       * there is no replacement. Stop reading it.
+       */
+      csp_id?: string | null;
+
+      identity_status?: 'SELF_DECLARED' | 'UNVERIFIED' | 'VERIFIED' | 'VETTED_VERIFIED' | null;
+
+      /**
+       * Whether this brand is inherited from the parent organization
+       */
+      is_inherited?: boolean;
+
+      status?: 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | null;
+
+      /**
+       * When the brand was submitted to TCR
+       */
+      submitted_at?: string | null;
+
+      /**
+       * Whether this brand has been submitted to TCR
+       */
+      submitted_to_tcr?: boolean;
+
+      /**
+       * TCR brand ID (populated after TCR submission)
+       */
+      tcr_brand_id?: string | null;
+
+      /**
+       * Universal EIN from TCR
+       */
+      universal_ein?: string | null;
+
+      /**
+       * When the brand was last updated
+       */
+      updated_at?: string | null;
+    }
+
+    export namespace Brand {
+      /**
+       * Business details and address information
+       */
+      export interface Business {
+        /**
+         * City
+         */
+        city?: string | null;
+
+        /**
+         * Country code (e.g., US, CA)
+         */
+        country?: string | null;
+
+        /**
+         * Country where the business is registered
+         */
+        country_of_registration?: string | null;
+
+        /**
+         * Business entity type
+         */
+        entity_type?: string | null;
+
+        /**
+         * Legal business name
+         */
+        legal_name?: string | null;
+
+        /**
+         * Postal/ZIP code
+         */
+        postal_code?: string | null;
+
+        /**
+         * State/province code
+         */
+        state?: string | null;
+
+        /**
+         * Street address
+         */
+        street?: string | null;
+
+        /**
+         * Tax ID/EIN number
+         */
+        tax_id?: string | null;
+
+        /**
+         * Type of tax ID (e.g., us_ein, ca_bn)
+         */
+        tax_id_type?: string | null;
+
+        /**
+         * Business website URL
+         */
+        url?: string | null;
+      }
+
+      /**
+       * Compliance and TCR-related information
+       */
+      export interface Compliance {
+        brand_relationship?: ProfilesAPI.TcrBrandRelationship | null;
+
+        /**
+         * List of destination countries for messaging
+         */
+        destination_countries?: Array<ProfilesAPI.DestinationCountry>;
+
+        /**
+         * Whether this is a TCR (Campaign Registry) application
+         */
+        is_tcr_application?: boolean;
+
+        /**
+         * Additional notes about the business or use case
+         */
+        notes?: string | null;
+
+        /**
+         * Phone number prefix for messaging (e.g., "+1")
+         */
+        phone_number_prefix?: string | null;
+
+        /**
+         * @deprecated Always null. The brand's free-text primary use case is no longer
+         * stored: it reached neither TCR nor any decision, and its column is dropped with
+         * no backfill, because the values were prose and the typed equivalent is the
+         * campaign's MessagingUseCaseUS.
+         *
+         * Retained so existing v3 clients reading primary_use_case keep deserializing.
+         * Unlike the profile sharing flags, which can answer false truthfully, there is no
+         * value to report here — the field is present and empty rather than present and
+         * wrong.
+         */
+        primary_use_case?: string | null;
+
+        vertical?: ProfilesAPI.TcrVertical | null;
+      }
+
+      /**
+       * Contact information for the brand
+       */
+      export interface Contact {
+        /**
+         * Business/brand name
+         */
+        business_name?: string | null;
+
+        /**
+         * Contact email address
+         */
+        email?: string | null;
+
+        /**
+         * Primary contact name
+         */
+        name?: string;
+
+        /**
+         * Contact phone number in E.164 format
+         */
+        phone?: string | null;
+
+        /**
+         * Contact phone country code (e.g., "1" for US)
+         */
+        phone_country_code?: string | null;
+
+        /**
+         * Contact's role in the business
+         */
+        role?: string | null;
+      }
+    }
+  }
+
+  /**
+   * Error information
+   */
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
+
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
+
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
+
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
+
+  /**
+   * Request and response metadata
+   */
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
+
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
+
+    /**
+     * API version used for this request
+     */
+    version?: string;
+  }
+}
+
+/**
+ * Standard API response envelope for all v3 endpoints
+ */
+export interface ProfileListResponse {
+  /**
+   * The profiles in the organization.
+   */
+  data?: ProfileListResponse.Data | null;
+
+  /**
+   * Error information
+   */
+  error?: ProfileListResponse.Error | null;
+
+  /**
+   * Request and response metadata
+   */
+  meta?: ProfileListResponse.Meta;
+
+  /**
+   * Indicates whether the request was successful
+   */
+  success?: boolean;
+}
+
+export namespace ProfileListResponse {
+  /**
+   * The profiles in the organization.
+   */
+  export interface Data {
+    /**
+     * Pagination metadata for list responses
+     */
+    pagination?: Data.Pagination;
+
+    /**
+     * The profiles on this page.
+     */
+    profiles?: Array<Data.Profile>;
+  }
+
+  export namespace Data {
+    /**
+     * Pagination metadata for list responses
+     */
+    export interface Pagination {
+      /**
+       * @deprecated Cursor-based pagination. Never populated — see Cursors.
+       */
+      cursors?: Pagination.Cursors | null;
+
+      /**
+       * Whether there are more pages after this one
+       */
+      has_more?: boolean;
+
+      /**
+       * Current page number (1-indexed)
+       */
+      page?: number;
+
+      /**
+       * Number of items per page
+       */
+      page_size?: number;
+
+      /**
+       * Total number of items across all pages
+       */
+      total_count?: number;
+
+      /**
+       * Total number of pages
+       */
+      total_pages?: number;
+    }
+
+    export namespace Pagination {
+      /**
+       * @deprecated Cursor-based pagination. Never populated — see Cursors.
+       */
+      export interface Cursors {
+        /**
+         * Cursor to fetch the next page.
+         */
+        after?: string | null;
+
+        /**
+         * Cursor to fetch the previous page.
+         */
+        before?: string | null;
+      }
+    }
+
+    /**
+     * Detailed profile response for v3 API
+     */
+    export interface Profile {
+      /**
+       * Profile unique identifier
+       */
+      id?: string;
+
+      /**
+       * @deprecated Always false. A profile no longer shares contacts with sibling
+       * profiles — it sees only what it owns. Retained so existing v3 clients reading
+       * allow_contact_sharing keep deserializing; it carries no information.
+       */
+      allow_contact_sharing?: boolean | null;
+
+      /**
+       * Whether number changes are allowed during onboarding
+       */
+      allow_number_change_during_onboarding?: boolean | null;
+
+      /**
+       * @deprecated Always false. A profile no longer shares templates with sibling
+       * profiles. Retained so existing v3 clients reading allow_template_sharing keep
+       * deserializing; it carries no information.
+       */
+      allow_template_sharing?: boolean | null;
+
+      /**
+       * Billing contact info returned in profile responses
+       */
+      billing_contact?: Profile.BillingContact | null;
+
+      /**
+       * Billing model: profile, organization, or profile_and_organization
+       */
+      billing_model?: string;
+
+      /**
+       * Brand response with nested contact, business, and compliance sections — mirrors
+       * the request structure.
+       */
+      brand?: Profile.Brand | null;
+
+      /**
+       * When the profile was created
+       */
+      created_at?: string;
+
+      /**
+       * Profile description
+       */
+      description?: string | null;
+
+      /**
+       * Profile email (inherited from organization)
+       */
+      email?: string | null;
+
+      /**
+       * Profile icon URL
+       */
+      icon?: string | null;
+
+      /**
+       * @deprecated Always false. A profile no longer inherits its organization's
+       * contacts. Retained so existing v3 clients reading inherit_contacts keep
+       * deserializing; it carries no information.
+       */
+      inherit_contacts?: boolean | null;
+
+      /**
+       * Whether this profile inherits TCR brand from the organization
+       */
+      inherit_tcr_brand?: boolean;
+
+      /**
+       * Whether this profile inherits TCR campaign from the organization
+       */
+      inherit_tcr_campaign?: boolean;
+
+      /**
+       * @deprecated Always false. A profile no longer inherits its organization's
+       * templates. Retained so existing v3 clients reading inherit_templates keep
+       * deserializing; it carries no information.
+       */
+      inherit_templates?: boolean | null;
+
+      /**
+       * Profile name
+       */
+      name?: string;
+
+      /**
+       * Parent organization ID
+       */
+      organization_id?: string | null;
+
+      /**
+       * Direct SMS phone number
+       */
+      sending_phone_number?: string | null;
+
+      /**
+       * @deprecated Deprecated. Always null. Sender borrowing is gone: a profile no
+       * longer points at another profile for its SMS sender, and every profile owns the
+       * sender it sends from.
+       *
+       * Kept on the wire, and never populated, because those are two different promises.
+       * Removing the key changes the response's shape — a generated client loses the
+       * property and stops compiling on the next regenerate, for a value that is now
+       * null for every profile in existence. Keeping it null costs a key and breaks
+       * nobody, and null is the honest answer rather than a placeholder: there is no
+       * borrowing left to report.
+       *
+       * Nothing could populate it. Migration 260813161500 dropped the column and copied
+       * each borrower its own channel-provider row; its Down() says outright that the
+       * borrower-to-lender pairing is not recoverable. The only surviving trace is a
+       * notes string on the copied row.
+       */
+      sending_phone_number_profile_id?: string | null;
+
+      /**
+       * @deprecated
+       */
+      sending_whatsapp_number_profile_id?: string | null;
+
+      /**
+       * Profile short name/abbreviation. 3–11 characters: letters, numbers, and spaces
+       * only, with at least one letter.
+       */
+      short_name?: string | null;
+
+      /**
+       * Profile setup status: incomplete, pending_review, approved, rejected
+       */
+      status?: string;
+
+      /**
+       * When the profile was last updated
+       */
+      updated_at?: string | null;
+
+      /**
+       * WhatsApp Business Account ID associated with this profile. Present whether the
+       * WABA is inherited from the organization or configured directly.
+       */
+      waba_id?: string | null;
+
+      /**
+       * Direct WhatsApp phone number
+       */
+      whatsapp_phone_number?: string | null;
+    }
+
+    export namespace Profile {
+      /**
+       * Billing contact info returned in profile responses
+       */
+      export interface BillingContact {
+        address?: string | null;
+
+        email?: string | null;
+
+        name?: string | null;
+
+        phone?: string | null;
+      }
+
+      /**
+       * Brand response with nested contact, business, and compliance sections — mirrors
+       * the request structure.
+       */
+      export interface Brand {
+        /**
+         * Unique identifier for the brand
+         */
+        id?: string;
+
+        /**
+         * Business details and address information
+         */
+        business?: Brand.Business | null;
+
+        /**
+         * Compliance and TCR-related information
+         */
+        compliance?: Brand.Compliance | null;
+
+        /**
+         * Contact information for the brand
+         */
+        contact?: Brand.Contact | null;
+
+        /**
+         * When the brand was created
+         */
+        created_at?: string;
+
+        /**
+         * @deprecated Deprecated and scheduled for removal. Identifies the Campaign
+         * Service Provider that registered the brand, which is Sent, so the value is the
+         * same for every brand and every account. Nothing on your side can act on it and
+         * there is no replacement. Stop reading it.
+         */
+        csp_id?: string | null;
+
+        identity_status?: 'SELF_DECLARED' | 'UNVERIFIED' | 'VERIFIED' | 'VETTED_VERIFIED' | null;
+
+        /**
+         * Whether this brand is inherited from the parent organization
+         */
+        is_inherited?: boolean;
+
+        status?: 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | null;
+
+        /**
+         * When the brand was submitted to TCR
+         */
+        submitted_at?: string | null;
+
+        /**
+         * Whether this brand has been submitted to TCR
+         */
+        submitted_to_tcr?: boolean;
+
+        /**
+         * TCR brand ID (populated after TCR submission)
+         */
+        tcr_brand_id?: string | null;
+
+        /**
+         * Universal EIN from TCR
+         */
+        universal_ein?: string | null;
+
+        /**
+         * When the brand was last updated
+         */
+        updated_at?: string | null;
+      }
+
+      export namespace Brand {
+        /**
+         * Business details and address information
+         */
+        export interface Business {
+          /**
+           * City
+           */
+          city?: string | null;
+
+          /**
+           * Country code (e.g., US, CA)
+           */
+          country?: string | null;
+
+          /**
+           * Country where the business is registered
+           */
+          country_of_registration?: string | null;
+
+          /**
+           * Business entity type
+           */
+          entity_type?: string | null;
+
+          /**
+           * Legal business name
+           */
+          legal_name?: string | null;
+
+          /**
+           * Postal/ZIP code
+           */
+          postal_code?: string | null;
+
+          /**
+           * State/province code
+           */
+          state?: string | null;
+
+          /**
+           * Street address
+           */
+          street?: string | null;
+
+          /**
+           * Tax ID/EIN number
+           */
+          tax_id?: string | null;
+
+          /**
+           * Type of tax ID (e.g., us_ein, ca_bn)
+           */
+          tax_id_type?: string | null;
+
+          /**
+           * Business website URL
+           */
+          url?: string | null;
+        }
+
+        /**
+         * Compliance and TCR-related information
+         */
+        export interface Compliance {
+          brand_relationship?: ProfilesAPI.TcrBrandRelationship | null;
+
+          /**
+           * List of destination countries for messaging
+           */
+          destination_countries?: Array<ProfilesAPI.DestinationCountry>;
+
+          /**
+           * Whether this is a TCR (Campaign Registry) application
+           */
+          is_tcr_application?: boolean;
+
+          /**
+           * Additional notes about the business or use case
+           */
+          notes?: string | null;
+
+          /**
+           * Phone number prefix for messaging (e.g., "+1")
+           */
+          phone_number_prefix?: string | null;
+
+          /**
+           * @deprecated Always null. The brand's free-text primary use case is no longer
+           * stored: it reached neither TCR nor any decision, and its column is dropped with
+           * no backfill, because the values were prose and the typed equivalent is the
+           * campaign's MessagingUseCaseUS.
+           *
+           * Retained so existing v3 clients reading primary_use_case keep deserializing.
+           * Unlike the profile sharing flags, which can answer false truthfully, there is no
+           * value to report here — the field is present and empty rather than present and
+           * wrong.
+           */
+          primary_use_case?: string | null;
+
+          vertical?: ProfilesAPI.TcrVertical | null;
+        }
+
+        /**
+         * Contact information for the brand
+         */
+        export interface Contact {
+          /**
+           * Business/brand name
+           */
+          business_name?: string | null;
+
+          /**
+           * Contact email address
+           */
+          email?: string | null;
+
+          /**
+           * Primary contact name
+           */
+          name?: string;
+
+          /**
+           * Contact phone number in E.164 format
+           */
+          phone?: string | null;
+
+          /**
+           * Contact phone country code (e.g., "1" for US)
+           */
+          phone_country_code?: string | null;
+
+          /**
+           * Contact's role in the business
+           */
+          role?: string | null;
+        }
+      }
+    }
+  }
+
+  /**
+   * Error information
+   */
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
+
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
+
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
+
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
+
+  /**
+   * Request and response metadata
+   */
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
+
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
+
+    /**
+     * API version used for this request
+     */
+    version?: string;
+  }
+}
+
+/**
+ * Standard API response envelope for all v3 endpoints
+ */
+export interface ProfileCompleteResponse {
+  /**
+   * Response when a profile is already in the completed state and no further action
+   * is taken.
+   */
+  data?: ProfileCompleteResponse.Data | null;
+
+  /**
+   * Error information
+   */
+  error?: ProfileCompleteResponse.Error | null;
+
+  /**
+   * Request and response metadata
+   */
+  meta?: ProfileCompleteResponse.Meta;
+
+  /**
+   * Indicates whether the request was successful
+   */
+  success?: boolean;
+}
+
+export namespace ProfileCompleteResponse {
+  /**
+   * Response when a profile is already in the completed state and no further action
+   * is taken.
+   */
+  export interface Data {
+    /**
+     * Human-readable message describing the result.
+     */
+    message?: string;
+
+    /**
+     * Current process status of the profile (e.g., "completed", "submitted",
+     * "in_progress").
+     */
+    status?: string;
+  }
+
+  /**
+   * Error information
+   */
+  export interface Error {
+    /**
+     * Machine-readable error code (e.g., "RESOURCE_001")
+     */
+    code?: string;
+
+    /**
+     * Additional validation error details (field-level errors)
+     */
+    details?: { [key: string]: Array<string> } | null;
+
+    /**
+     * URL to documentation about this error
+     */
+    doc_url?: string | null;
+
+    /**
+     * Human-readable error message
+     */
+    message?: string;
+  }
+
+  /**
+   * Request and response metadata
+   */
+  export interface Meta {
+    /**
+     * Unique identifier for this request (for tracing and support)
+     */
+    request_id?: string;
+
+    /**
+     * Server timestamp when the response was generated
+     */
+    timestamp?: string;
+
+    /**
+     * API version used for this request
+     */
+    version?: string;
+  }
+}
+
+export interface ProfileCreateParams {
+  /**
+   * @deprecated Body param: Deprecated. Accepted and ignored. Contact and template
+   * sharing between sender profiles is gone — a profile sees only what it owns, and
+   * the organization still sees all of its profiles' contacts and templates through
+   * read-time widening. The four columns behind these flags were dropped by
+   * M260720120000.
+   *
+   * Bound rather than dropped so the properties survive on the wire and in a
+   * generated client: an SDK that assigns them keeps compiling, which is the
+   * compatibility this exists for. Deliberately not refused either — a 400 would
+   * break an integration that is otherwise working, and the capability they ask for
+   * is gone either way. Same rule as SendingPhoneNumberProfileId.
+   *
+   * The read is what makes this survivable: every profile reports all four as false,
+   * so a caller that checks its own write can see it did not take. Requests carrying
+   * one are logged, so we can tell when nobody sends them any more and the fields
+   * can go for real.
+   */
+  allow_contact_sharing?: boolean | null;
+
+  /**
+   * @deprecated Body param
+   */
+  allow_template_sharing?: boolean | null;
 
   /**
    * Body param: Billing contact information for a profile. Required when
    * billing_model is "profile" or "profile_and_organization".
    */
-  billing_contact?: BillingContactInfo | null;
+  billing_contact?: ProfileCreateParams.BillingContact | null;
 
   /**
    * Body param: Billing model: profile, organization, or profile_and_organization
@@ -1004,92 +2354,293 @@ export interface ProfileCreateParams {
    * Body param: Brand and KYC data grouped into contact, business, and compliance
    * sections
    */
-  brand?: BrandsBrandData | null;
+  brand?: ProfileCreateParams.Brand | null;
+
+  /**
+   * Body param: Profile description (optional)
+   */
+  description?: string | null;
+
+  /**
+   * Body param: Profile icon URL (optional)
+   */
+  icon?: string | null;
+
+  /**
+   * @deprecated Body param
+   */
+  inherit_contacts?: boolean | null;
+
+  /**
+   * Body param: Whether this profile inherits TCR brand from organization (default:
+   * false)
+   */
+  inherit_tcr_brand?: boolean | null;
+
+  /**
+   * Body param: Whether this profile inherits TCR campaign from organization
+   * (default: false)
+   */
+  inherit_tcr_campaign?: boolean | null;
+
+  /**
+   * @deprecated Body param
+   */
+  inherit_templates?: boolean | null;
+
+  /**
+   * Body param: Profile name (required)
+   */
+  name?: string;
+
+  /**
+   * Body param: Payment card details for this profile (optional). Accepted when
+   * billing_model is "profile" or "profile_and_organization". Not persisted on our
+   * servers — forwarded to the payment processor.
+   */
+  payment_details?: ProfileCreateParams.PaymentDetails | null;
+
+  /**
+   * Body param: Sandbox flag - when true, the operation is simulated without side
+   * effects Useful for testing integrations without actual execution
+   */
+  sandbox?: boolean;
+
+  /**
+   * Body param: Profile short name/abbreviation (optional). Must be 3–11 characters,
+   * contain only letters, numbers, and spaces, and include at least one letter.
+   * Example: "SALES", "Mkt 2", "Support1".
+   */
+  short_name?: string | null;
+
+  /**
+   * Body param: Direct WhatsApp Business Account credentials for a profile. Use this
+   * when the profile should have its own WhatsApp Business Account instead of
+   * inheriting from the organization. Credentials must be obtained from Meta
+   * Business Manager by creating a System User with whatsapp_business_messaging and
+   * whatsapp_business_management scopes.
+   */
+  whatsapp_business_account?: ProfileCreateParams.WhatsappBusinessAccount | null;
+
+  /**
+   * Header param: Unique key to ensure idempotent request processing. Must be 1-255
+   * alphanumeric characters, hyphens, or underscores. Responses are cached for 24
+   * hours per key per customer.
+   */
+  'Idempotency-Key'?: string;
+
+  /**
+   * Header param: Profile UUID to scope the request to a child profile. Only
+   * organization API keys can use this header. The profile must belong to the
+   * calling organization.
+   */
+  'x-profile-id'?: string;
+}
+
+export namespace ProfileCreateParams {
+  /**
+   * Billing contact information for a profile. Required when billing_model is
+   * "profile" or "profile_and_organization".
+   */
+  export interface BillingContact {
+    /**
+     * Email address where invoices will be sent (required)
+     */
+    email: string;
+
+    /**
+     * Full name of the billing contact or company (required)
+     */
+    name: string;
+
+    /**
+     * Billing address (optional). Free-form text including street, city, state, postal
+     * code, and country.
+     */
+    address?: string | null;
+
+    /**
+     * Phone number for the billing contact (optional)
+     */
+    phone?: string | null;
+  }
+
+  /**
+   * Brand and KYC data grouped into contact, business, and compliance sections
+   */
+  export interface Brand {
+    /**
+     * Compliance and TCR information for brand registration
+     */
+    compliance: Brand.Compliance;
+
+    /**
+     * Contact information for brand KYC
+     */
+    contact: Brand.Contact;
+
+    /**
+     * Business details and address for brand KYC
+     */
+    business?: Brand.Business | null;
+  }
+
+  export namespace Brand {
+    /**
+     * Compliance and TCR information for brand registration
+     */
+    export interface Compliance {
+      brandRelationship: ProfilesAPI.TcrBrandRelationship;
+
+      vertical: ProfilesAPI.TcrVertical;
+
+      /**
+       * List of destination countries for messaging
+       */
+      destinationCountries?: Array<ProfilesAPI.DestinationCountry> | null;
+
+      /**
+       * Whether this is a TCR (Campaign Registry) application
+       */
+      isTcrApplication?: boolean | null;
+
+      /**
+       * Additional notes about the business or use case
+       */
+      notes?: string | null;
+
+      /**
+       * Phone number prefix for messaging (e.g., "+1")
+       */
+      phoneNumberPrefix?: string | null;
+    }
+
+    /**
+     * Contact information for brand KYC
+     */
+    export interface Contact {
+      /**
+       * Primary contact name (required)
+       */
+      name: string;
+
+      /**
+       * Business/brand name
+       */
+      businessName?: string | null;
+
+      /**
+       * Contact email address
+       */
+      email?: string | null;
+
+      /**
+       * Contact phone number in E.164 format
+       */
+      phone?: string | null;
+
+      /**
+       * Contact phone country code (e.g., "1" for US)
+       */
+      phoneCountryCode?: string | null;
+
+      /**
+       * Contact's role in the business
+       */
+      role?: string | null;
+    }
+
+    /**
+     * Business details and address for brand KYC
+     */
+    export interface Business {
+      /**
+       * City
+       */
+      city?: string | null;
+
+      /**
+       * Country code (e.g., US, CA)
+       */
+      country?: string | null;
 
-  /**
-   * Body param: Profile description (optional)
-   */
-  description?: string | null;
+      /**
+       * Country where the business is registered
+       */
+      countryOfRegistration?: string | null;
 
-  /**
-   * Body param: Profile icon URL (optional)
-   */
-  icon?: string | null;
+      entityType?:
+        | 'PRIVATE_PROFIT'
+        | 'PUBLIC_PROFIT'
+        | 'NON_PROFIT'
+        | 'SOLE_PROPRIETOR'
+        | 'GOVERNMENT'
+        | null;
 
-  /**
-   * Body param: Whether this profile inherits contacts from organization (default:
-   * true)
-   */
-  inherit_contacts?: boolean | null;
+      /**
+       * Legal business name
+       */
+      legalName?: string | null;
 
-  /**
-   * Body param: Whether this profile inherits TCR brand from organization (default:
-   * true)
-   */
-  inherit_tcr_brand?: boolean | null;
+      /**
+       * Postal/ZIP code
+       */
+      postalCode?: string | null;
 
-  /**
-   * Body param: Whether this profile inherits TCR campaign from organization
-   * (default: true)
-   */
-  inherit_tcr_campaign?: boolean | null;
+      /**
+       * State/province code
+       */
+      state?: string | null;
 
-  /**
-   * Body param: Whether this profile inherits templates from organization (default:
-   * true)
-   */
-  inherit_templates?: boolean | null;
+      /**
+       * Street address
+       */
+      street?: string | null;
 
-  /**
-   * Body param: Profile name (required)
-   */
-  name?: string;
+      /**
+       * Tax ID/EIN number
+       */
+      taxId?: string | null;
 
-  /**
-   * Body param: Payment card details for a profile. Accepted when billing_model is
-   * "profile" or "profile_and_organization". These details are not stored on our
-   * servers and will be forwarded to the payment processor.
-   */
-  payment_details?: PaymentDetails | null;
+      /**
+       * Type of tax ID (e.g., us_ein, ca_bn)
+       */
+      taxIdType?: string | null;
 
-  /**
-   * Body param: Sandbox flag - when true, the operation is simulated without side
-   * effects Useful for testing integrations without actual execution
-   */
-  sandbox?: boolean;
+      /**
+       * Business website URL
+       */
+      url?: string | null;
+    }
+  }
 
   /**
-   * Body param: Profile short name/abbreviation (optional). Must be 3–11 characters,
-   * contain only letters, numbers, and spaces, and include at least one letter.
-   * Example: "SALES", "Mkt 2", "Support1".
+   * Payment card details for this profile (optional). Accepted when billing_model is
+   * "profile" or "profile_and_organization". Not persisted on our servers —
+   * forwarded to the payment processor.
    */
-  short_name?: string | null;
+  export interface PaymentDetails {
+    /**
+     * Card number (digits only, 13–19 characters)
+     */
+    card_number: string;
 
-  /**
-   * Body param: Direct WhatsApp Business Account credentials for a profile. Use this
-   * when the profile should have its own WhatsApp Business Account instead of
-   * inheriting from the organization. Credentials must be obtained from Meta
-   * Business Manager by creating a System User with whatsapp_business_messaging and
-   * whatsapp_business_management scopes.
-   */
-  whatsapp_business_account?: ProfileCreateParams.WhatsappBusinessAccount | null;
+    /**
+     * Card security code (3–4 digits)
+     */
+    cvc: string;
 
-  /**
-   * Header param: Unique key to ensure idempotent request processing. Must be 1-255
-   * alphanumeric characters, hyphens, or underscores. Responses are cached for 24
-   * hours per key per customer.
-   */
-  'Idempotency-Key'?: string;
+    /**
+     * Card expiry date in MM/YY format (e.g. "09/27")
+     */
+    expiry: string;
 
-  /**
-   * Header param: Profile UUID to scope the request to a child profile. Only
-   * organization API keys can use this header. The profile must belong to the
-   * calling organization.
-   */
-  'x-profile-id'?: string;
-}
+    /**
+     * Billing ZIP / postal code associated with the card
+     */
+    zip_code: string;
+  }
 
-export namespace ProfileCreateParams {
   /**
    * Direct WhatsApp Business Account credentials for a profile. Use this when the
    * profile should have its own WhatsApp Business Account instead of inheriting from
@@ -1130,7 +2681,17 @@ export interface ProfileRetrieveParams {
 
 export interface ProfileUpdateParams {
   /**
-   * Body param: Whether contacts are shared across profiles (optional)
+   * @deprecated Body param: Deprecated. Accepted and ignored. Contact and template
+   * sharing between sender profiles is gone — a profile sees only what it owns, and
+   * the organization still sees all of its profiles' contacts and templates through
+   * read-time widening. The four columns behind these flags were dropped by
+   * M260720120000.
+   *
+   * Retired the same way as SendingPhoneNumberProfileId, and for the same reason:
+   * the properties stay bound so an SDK that assigns them keeps compiling, and a 400
+   * would break a working integration over a capability that is gone regardless.
+   * Every profile reports all four as false, so a caller that checks its own write
+   * can see it did not take.
    */
   allow_contact_sharing?: boolean | null;
 
@@ -1140,7 +2701,7 @@ export interface ProfileUpdateParams {
   allow_number_change_during_onboarding?: boolean | null;
 
   /**
-   * Body param: Whether templates are shared across profiles (optional)
+   * @deprecated Body param
    */
   allow_template_sharing?: boolean | null;
 
@@ -1148,7 +2709,7 @@ export interface ProfileUpdateParams {
    * Body param: Billing contact information for a profile. Required when
    * billing_model is "profile" or "profile_and_organization".
    */
-  billing_contact?: BillingContactInfo | null;
+  billing_contact?: ProfileUpdateParams.BillingContact | null;
 
   /**
    * Body param: Billing model: profile, organization, or profile_and_organization
@@ -1166,7 +2727,7 @@ export interface ProfileUpdateParams {
    * Body param: Brand and KYC data grouped into contact, business, and compliance
    * sections
    */
-  brand?: BrandsBrandData | null;
+  brand?: ProfileUpdateParams.Brand | null;
 
   /**
    * Body param: Profile description (optional)
@@ -1179,7 +2740,7 @@ export interface ProfileUpdateParams {
   icon?: string | null;
 
   /**
-   * Body param: Whether this profile inherits contacts from organization (optional)
+   * @deprecated Body param
    */
   inherit_contacts?: boolean | null;
 
@@ -1195,7 +2756,7 @@ export interface ProfileUpdateParams {
   inherit_tcr_campaign?: boolean | null;
 
   /**
-   * Body param: Whether this profile inherits templates from organization (optional)
+   * @deprecated Body param
    */
   inherit_templates?: boolean | null;
 
@@ -1205,11 +2766,11 @@ export interface ProfileUpdateParams {
   name?: string | null;
 
   /**
-   * Body param: Payment card details for a profile. Accepted when billing_model is
-   * "profile" or "profile_and_organization". These details are not stored on our
-   * servers and will be forwarded to the payment processor.
+   * Body param: Payment card details for this profile (optional). Accepted when
+   * billing_model is "profile" or "profile_and_organization". Not persisted on our
+   * servers — forwarded to the payment processor.
    */
-  payment_details?: PaymentDetails | null;
+  payment_details?: ProfileUpdateParams.PaymentDetails | null;
 
   /**
    * Body param: Sandbox flag - when true, the operation is simulated without side
@@ -1223,13 +2784,30 @@ export interface ProfileUpdateParams {
   sending_phone_number?: string | null;
 
   /**
-   * Body param: Reference to another profile to use for SMS configuration (optional)
+   * @deprecated Body param: Deprecated. Accepted and ignored. Sender borrowing is
+   * gone: a profile cannot send from another profile's SMS number. Supplying this
+   * changes nothing and the request still succeeds.
+   *
+   * Bound rather than dropped so the property survives on the wire and in a
+   * generated client — an SDK that assigns it keeps compiling, which is the
+   * compatibility this exists for. It is deliberately not refused: a 400 here would
+   * break an integration that is otherwise working, and the capability it asks for
+   * is gone either way.
+   *
+   * The trade-off, stated plainly. A caller asking for borrowing is told it
+   * succeeded when nothing happened. What makes that survivable is the read:
+   * sending_phone_number_profile_id comes back null on every profile, so a caller
+   * that checks its own write can see it did not take. Every request that carries
+   * one is logged, so we can tell when nobody is sending it any more and the field
+   * can go for real.
+   *
+   * Give the profile a sender of its own instead: POST /v3/channels/sms with the
+   * x-profile-id header naming it.
    */
   sending_phone_number_profile_id?: string | null;
 
   /**
-   * Body param: Reference to another profile to use for WhatsApp configuration
-   * (optional)
+   * @deprecated Body param
    */
   sending_whatsapp_number_profile_id?: string | null;
 
@@ -1260,6 +2838,211 @@ export interface ProfileUpdateParams {
   'x-profile-id'?: string;
 }
 
+export namespace ProfileUpdateParams {
+  /**
+   * Billing contact information for a profile. Required when billing_model is
+   * "profile" or "profile_and_organization".
+   */
+  export interface BillingContact {
+    /**
+     * Email address where invoices will be sent (required)
+     */
+    email: string;
+
+    /**
+     * Full name of the billing contact or company (required)
+     */
+    name: string;
+
+    /**
+     * Billing address (optional). Free-form text including street, city, state, postal
+     * code, and country.
+     */
+    address?: string | null;
+
+    /**
+     * Phone number for the billing contact (optional)
+     */
+    phone?: string | null;
+  }
+
+  /**
+   * Brand and KYC data grouped into contact, business, and compliance sections
+   */
+  export interface Brand {
+    /**
+     * Compliance and TCR information for brand registration
+     */
+    compliance: Brand.Compliance;
+
+    /**
+     * Contact information for brand KYC
+     */
+    contact: Brand.Contact;
+
+    /**
+     * Business details and address for brand KYC
+     */
+    business?: Brand.Business | null;
+  }
+
+  export namespace Brand {
+    /**
+     * Compliance and TCR information for brand registration
+     */
+    export interface Compliance {
+      brandRelationship: ProfilesAPI.TcrBrandRelationship;
+
+      vertical: ProfilesAPI.TcrVertical;
+
+      /**
+       * List of destination countries for messaging
+       */
+      destinationCountries?: Array<ProfilesAPI.DestinationCountry> | null;
+
+      /**
+       * Whether this is a TCR (Campaign Registry) application
+       */
+      isTcrApplication?: boolean | null;
+
+      /**
+       * Additional notes about the business or use case
+       */
+      notes?: string | null;
+
+      /**
+       * Phone number prefix for messaging (e.g., "+1")
+       */
+      phoneNumberPrefix?: string | null;
+    }
+
+    /**
+     * Contact information for brand KYC
+     */
+    export interface Contact {
+      /**
+       * Primary contact name (required)
+       */
+      name: string;
+
+      /**
+       * Business/brand name
+       */
+      businessName?: string | null;
+
+      /**
+       * Contact email address
+       */
+      email?: string | null;
+
+      /**
+       * Contact phone number in E.164 format
+       */
+      phone?: string | null;
+
+      /**
+       * Contact phone country code (e.g., "1" for US)
+       */
+      phoneCountryCode?: string | null;
+
+      /**
+       * Contact's role in the business
+       */
+      role?: string | null;
+    }
+
+    /**
+     * Business details and address for brand KYC
+     */
+    export interface Business {
+      /**
+       * City
+       */
+      city?: string | null;
+
+      /**
+       * Country code (e.g., US, CA)
+       */
+      country?: string | null;
+
+      /**
+       * Country where the business is registered
+       */
+      countryOfRegistration?: string | null;
+
+      entityType?:
+        | 'PRIVATE_PROFIT'
+        | 'PUBLIC_PROFIT'
+        | 'NON_PROFIT'
+        | 'SOLE_PROPRIETOR'
+        | 'GOVERNMENT'
+        | null;
+
+      /**
+       * Legal business name
+       */
+      legalName?: string | null;
+
+      /**
+       * Postal/ZIP code
+       */
+      postalCode?: string | null;
+
+      /**
+       * State/province code
+       */
+      state?: string | null;
+
+      /**
+       * Street address
+       */
+      street?: string | null;
+
+      /**
+       * Tax ID/EIN number
+       */
+      taxId?: string | null;
+
+      /**
+       * Type of tax ID (e.g., us_ein, ca_bn)
+       */
+      taxIdType?: string | null;
+
+      /**
+       * Business website URL
+       */
+      url?: string | null;
+    }
+  }
+
+  /**
+   * Payment card details for this profile (optional). Accepted when billing_model is
+   * "profile" or "profile_and_organization". Not persisted on our servers —
+   * forwarded to the payment processor.
+   */
+  export interface PaymentDetails {
+    /**
+     * Card number (digits only, 13–19 characters)
+     */
+    card_number: string;
+
+    /**
+     * Card security code (3–4 digits)
+     */
+    cvc: string;
+
+    /**
+     * Card expiry date in MM/YY format (e.g. "09/27")
+     */
+    expiry: string;
+
+    /**
+     * Billing ZIP / postal code associated with the card
+     */
+    zip_code: string;
+  }
+}
+
 export interface ProfileListParams {
   /**
    * Profile UUID to scope the request to a child profile. Only organization API keys
@@ -1315,17 +3098,12 @@ Profiles.Campaigns = Campaigns;
 
 export declare namespace Profiles {
   export {
-    type APIResponseOfProfileDetail as APIResponseOfProfileDetail,
-    type BillingContactInfo as BillingContactInfo,
-    type BrandBusinessInfo as BrandBusinessInfo,
-    type BrandComplianceInfo as BrandComplianceInfo,
-    type BrandContactInfo as BrandContactInfo,
-    type BrandsBrandData as BrandsBrandData,
     type DestinationCountry as DestinationCountry,
-    type PaymentDetails as PaymentDetails,
-    type ProfileDetail as ProfileDetail,
     type TcrBrandRelationship as TcrBrandRelationship,
     type TcrVertical as TcrVertical,
+    type ProfileCreateResponse as ProfileCreateResponse,
+    type ProfileRetrieveResponse as ProfileRetrieveResponse,
+    type ProfileUpdateResponse as ProfileUpdateResponse,
     type ProfileListResponse as ProfileListResponse,
     type ProfileCompleteResponse as ProfileCompleteResponse,
     type ProfileCreateParams as ProfileCreateParams,
@@ -1338,13 +3116,10 @@ export declare namespace Profiles {
 
   export {
     Campaigns as Campaigns,
-    type APIResponseOfBrandCampaign as APIResponseOfBrandCampaign,
-    type APIResponseOfListOfBrandCampaign as APIResponseOfListOfBrandCampaign,
-    type BrandCampaign as BrandCampaign,
-    type CampaignData as CampaignData,
-    type CampaignUseCase as CampaignUseCase,
-    type CampaignUseCaseData as CampaignUseCaseData,
     type MessagingUseCaseUs as MessagingUseCaseUs,
+    type CampaignCreateResponse as CampaignCreateResponse,
+    type CampaignUpdateResponse as CampaignUpdateResponse,
+    type CampaignListResponse as CampaignListResponse,
     type CampaignCreateParams as CampaignCreateParams,
     type CampaignUpdateParams as CampaignUpdateParams,
     type CampaignListParams as CampaignListParams,