---
title: "Begin launch process for sender"
method: POST
path: "/v1/projects/{projectId}/rcs/senders/{senderId}/launch"
tags: ["RCS Senders"]
---

# Begin launch process for sender

`POST /v1/projects/{projectId}/rcs/senders/{senderId}/launch`

## Request

- Base URL: `https://provisioning.api.sinch.com`
- URL: `https://provisioning.api.sinch.com/v1/projects/{projectId}/rcs/senders/{senderId}/launch`
- Auth: HTTP basic and HTTP bearer and OAuth 2
  - Client credentials
  - Token URL: `https://auth.sinch.com/oauth2/token`

Begins launch process for a sender in project.

      Requirements to begin launch process:
        - All required questionnaire answers must be provided;
        - For senders using the US V2 questionnaire, the verification phone number is required;
        - Country-specific questionnaire answers are required when applicable to the sender's countries;
        - Countries (`details.countries`) must have at least one (1) value;
        - At least one contact phone number (`details.brand.phones`) or a contact email (`details.brand.emails`) is required, but both are recommended;
        - A brand banner url (`details.brand.bannerUrl`) must be defined;
        - A brand logo url (`details.brand.logoUrl`) must be defined;
        - A privacy policy url (`details.brand.privacyPolicyUrl`) must be defined;
        - A terms of service url (`details.brand.termsOfServiceUrl`) must be defined;

      If no video URI was provided in questionnaire, Sender will go into PENDING_LAUNCH while a video is added by Service Implementation.

## Path parameters

- `projectId` string, required
- `senderId` string, required

## Response `200`

Launched sender in project

- RcsSenderDto
  - `id` string, required: The unique ID of the sender.
  - `conversationApiApp` string: If set, the Conversation API App ID the sender is connected to.
  - `conversationApiAppDetails` RcsConversationApiAppDto
    - `id` string, required: ID of the app
    - `projectId` string, required: ID of the app project
    - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required: App region.
    - `channelStatus` 'ACTIVE' | 'FAILING' | 'PENDING' | 'UNRECOGNIZED': Status of the channel credentials integration.
  - `state` 'DRAFT' | 'IN_PROGRESS' | 'IN_TEST' | 'LAUNCHED' | 'LAUNCHING' | 'PREPARING_LAUNCH' | 'UNLAUNCHED' | 'UNKNOWN': The current state of the sender.
  - `testNumberStates` RcsTestNumberStateDto[]: Test phone numbers states.
    - `number` string, e.164 phone number, required: Test phone number.
    - `state` 'DECLINED' | 'EXPIRED' | 'FAILED' | 'INVALID' | 'PENDING' | 'REJECTED' | 'UNVERIFIED' | 'VERIFIED' | 'UNRECOGNIZED', required: Test phone state.
    - `submitted` string, required: Date of submitting phone number.
  - `countryStatus` RcsCountryStatusDto[]: Countries status.
    - `country` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'UNRECOGNIZED', required: Two-letter country code in ISO 3166 standard.
    - `status` 'LAUNCHED' | 'NOT_LAUNCHED' | 'PENDING' | 'PENDING_UNLAUNCHED' | 'REJECTED' | 'SUSPENDED' | 'UNLAUNCHED' | 'INVALID_IN_GOOGLE_MY_BUSINESS' | 'UNRECOGNIZED', required: Operator status.
    - `operators` RcsOperatorDto[], required: Mobile network operators.
      - `name` string, required: Operator name.
      - `status` 'LAUNCHED' | 'NOT_LAUNCHED' | 'PENDING' | 'PENDING_UNLAUNCHED' | 'REJECTED' | 'SUSPENDED' | 'UNLAUNCHED' | 'INVALID_IN_GOOGLE_MY_BUSINESS' | 'UNRECOGNIZED', required: Operator status.
      - `remark` string: Any comments or notes to the current state.
      - `modified` string: Last date the operator changed state.
  - `details` RcsSenderDetailsDto
    - `brand` RcsSenderDetailsBrandDto
      - `name` string: Brand name.
      - `emails` RcsEmailDto[]: Contact emails.
        - `label` string, required: Contact email label.
        - `address` string, email, required: Contact email address.
      - `phones` RcsPhoneDto[]: Contact phone numbers.
        - `label` string, required: Contact phone label.
        - `number` string, required: Contact phone number. A phone number without country code and without separators, or a valid e.164 phone number.
      - `websites` RcsWebsiteDto[]: Contact websites.
        - `label` string, required: Contact website label.
        - `url` string, url, required: Contact website address.
      - `color` string, hex: Brand color (HEX code).
      - `description` string: Brand description.
      - `bannerUrl` string, url: Brand banner url.
      - `logoUrl` string, url: Brand logo url.
      - `privacyPolicyUrl` string, url: Privacy Policy URL.
      - `termsOfServiceUrl` string, url: Terms & Conditions URL.
    - `callbackUrl` string, url: Use Webhooks instead for sender update events.
    - `testNumbers` string[]: Phone numbers for testing. An agent can send 20 tester requests each day with a total maximum of 200 tester requests.
    - `countries` RcsCountryCodesEnum[]: List of two-letter country codes in ISO 3166 standard, specifying the countries to launch RCS sender in.
    - `questionnaire` RcsSenderDetailsQuestionnaireDto, required
      - `general` RcsSenderDetailsQuestionnaireGeneralDto, required
        - `questions` RcsSenderDetailsQuestionnaireGeneralQuestionsDto, required
          - `optInDescription` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `triggerDescription` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `interactionsDescription` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `optOutDescription` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `videoUris` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `screenshotUris` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
        - `answers` RcsSenderDetailsQuestionnaireGeneralAnswersDto, required
          - `optInDescription` string: How you obtain opt-in to message users.
          - `optInDescriptionMetadata` RcsSenderDetailsQuestionnaireAnswerMetadataDto
            - `ignore` string: Ignore given string on launch, e.g. custom delimiter.
          - `triggerDescription` string: Actions that triggers messages to users.
          - `triggerDescriptionMetadata` RcsSenderDetailsQuestionnaireAnswerMetadataDto
            - `ignore` string: Ignore given string on launch, e.g. custom delimiter.
          - `interactionsDescription` string: Interactions with users.
          - `interactionsDescriptionMetadata` RcsSenderDetailsQuestionnaireAnswerMetadataDto
            - `ignore` string: Ignore given string on launch, e.g. custom delimiter.
          - `optOutDescription` string: The message the sender sends when a user opts out.
          - `optOutDescriptionMetadata` RcsSenderDetailsQuestionnaireAnswerMetadataDto
            - `ignore` string: Ignore given string on launch, e.g. custom delimiter.
          - `videoUris` string[]: Publicly available URIs for videos of the sender, for review purposes only.
          - `screenshotUris` string[]: Publicly available URIs for screenshots of the sender, for review purposes only.
      - `verification` RcsSenderDetailsQuestionnaireVerificationDto, required
        - `questions` RcsSenderDetailsQuestionnaireVerificationQuestionsDto, required
          - `name` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `email` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `title` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `website` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `phone` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `partner` RcsSenderDetailsQuestionnaireVerificationPartnerQuestionsDto, required
            - `companyName` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `contactName` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `contactEmailAddress` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
        - `answers` RcsSenderDetailsQuestionnaireVerificationAnswersDto, required
          - `name` string: Name of verification contact.
          - `email` string, email: Email of verification contact.
          - `title` string: Title of verification contact.
          - `website` string, url: Website of verification contact.
          - `phone` string: Phone number of verification contact in E.164 format.
          - `partner` RcsSenderDetailsQuestionnaireVerificationPartnerAnswersDto
            - `companyName` string: Company name of the brand partner.
            - `contactName` string: Name of the contact person of the brand partner.
            - `contactEmailAddress` string, email: Email of the contact person of the brand partner.
      - `gb` RcsSenderDetailsQuestionnaireGBDto
        - `questions` RcsSenderDetailsQuestionnaireGBQuestionsDto, required
          - `brandIndustry` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `companyLegalName` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `companyRegistrationNumber` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `fullCompanyAddress` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `messagesVolume` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `messagesFrequency` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `campaignLength` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
        - `answers` RcsSenderDetailsQuestionnaireGBAnswersDto, required
          - `brandIndustry` string: Sector or industry of business. Not required for create, but required for launch.
          - `companyLegalName` string: The registered legal name of the company. Not required for create, but required for launch.
          - `companyRegistrationNumber` string: The company registration number.
          - `fullCompanyAddress` string: Full company address.
          - `fullCompanyAddressMetadata` RcsSenderDetailsQuestionnaireAnswerMetadataDto
            - `ignore` string: Ignore given string on launch, e.g. custom delimiter.
          - `messagesVolume` string: Messages volume. Not required for create, but required for launch.
          - `messagesFrequency` string: Messages frequency.
          - `campaignLength` string: Length of campaign.
      - `fr` RcsSenderDetailsQuestionnaireFRDto
        - `questions` RcsSenderDetailsQuestionnaireFRQuestionsDto, required
          - `fullCompanyAddress` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
          - `siren` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
            - `question` string, required: Human readable question.
            - `suggestedAnswers` string[], required: Suggested answers to the question.
        - `answers` RcsSenderDetailsQuestionnaireFRAnswersDto, required
          - `fullCompanyAddress` string: Full company address.
          - `fullCompanyAddressMetadata` RcsSenderDetailsQuestionnaireAnswerMetadataDto
            - `ignore` string: Ignore given string on launch, e.g. custom delimiter.
          - `siren` string: Company directory identification system number.
      - `us` union: Launch questions specific for US.
        - object
          - `questions` union, required: Launch questions specific for US.
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - `answers` RcsBrandCampaignSenderDetailsQuestionnaireUSAnswersDto, required
            - `ownershipType` 'PRIVATE' | 'PUBLIC': Ownership type of the company. Not required for create, but required for launch.
            - `companyLegalName` string: The registered legal name of the company. Not required for create, but required for launch.
            - `companyPhoneNumber` string: The registered phone number of the company. Not required for create, but required for launch.
            - `companyEmailAddress` string, email: The email address of the company. Not required for create, but required for launch.
            - `brandName` string: Brand name or Doing Business As (DBA). Must be legally associated with the provided legal company name. Not required for create, but required for launch.
            - `brandIndustry` 'AGRICULTURE' | 'COMMUNICATION' | 'CONSTRUCTION' | 'EDUCATION' | 'ENERGY' | 'ENTERTAINMENT' | 'FINANCIAL' | 'GAMBLING' | 'GOVERNMENT' | 'HEALTHCARE' | 'HOSPITALITY' | 'HUMAN_RESOURCES' | 'INSURANCE' | 'LEGAL' | 'MANUFACTURING' | 'NON_GOVERNMENTAL_ORGANIZATION' | 'POLITICAL' | 'POSTAL' | 'PROFESSIONAL' | 'REAL_ESTATE' | 'RETAIL' | 'TECHNOLOGY' | 'TRANSPORTATION': Sector or industry of business. Not required for create, but required for launch.
            - `legalForm` 'CORPORATION' | 'LIMITED_LIABILITY_COMPANY' | 'PARTNERSHIP' | 'S_CORPORATION': Legal form of the company.
            - `taxIdCountry` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW': Country of the company's tax registration.
            - `taxId` string: Tax registration identifier associated with the provided legal company name.
            - `addressLine` string: Street address line. Not required for create, but required for launch.
            - `addressCity` string: City. Not required for create, but required for launch.
            - `addressCountry` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW': Country of the company's tax registration.
            - `addressState` 'AK' | 'AL' | 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VA' | 'VI' | 'VT' | 'WA' | 'WI' | 'WV' | 'WY': State (US only). Not required for create, but required for launch.
            - `addressPostalCode` string: Postal code. Not required for create, but required for launch.
            - `websiteUrl` string: Primary website URL. Not required for create, but required for launch.
            - `contactFirstName` string: First name of the responsible contact person. Not required for create, but required for launch.
            - `contactSurname` string: Surname of the responsible contact person. Not required for create, but required for launch.
            - `stockExchange` string: Primary home country stock exchange abbreviation. Not required for create, but required for launch.
            - `stockSymbol` string: Primary home country stock symbol associated with stock exchange. Not required for create, but required for launch.
            - `sampleMessages` string[]: Sample messages for each use case or message type sent by the brand. Not required for create, but required for launch.
            - `messagesVolume` number: Messages volume. Not required for create, but required for launch.
            - `embeddedLink` boolean: Flag indicating if URL links will be embedded within message payloads.
            - `embeddedPhone` boolean: Flag indicating if phone numbers will be embedded within message payloads.
            - `ageGatedContent` boolean: Indicates if the campaign content is restricted by age (e.g., alcohol, tobacco).
            - `directLending` boolean: Indicates if the campaign involves direct financial lending, requiring stricter compliance.
            - `optInConfirmationMessage` string: Opt-in confirmation message sent to users. Not required for create, but required for launch.
            - `helpMessage` string: Help message of the campaign. Not required for create, but required for launch.
            - `callToActionMessage` string: Call to action message of the campaign. Not required for create, but required for launch.
        - object
          - `questions` RcsDefaultSenderDetailsQuestionnaireUSQuestionsDto, required
            - `ownershipType` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `companyLegalName` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `companyPhoneNumber` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `companyEmailAddress` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `brandName` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `brandIndustry` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `legalForm` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `taxIdCountry` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `taxId` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `addressLine` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `addressCity` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `addressCountry` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `addressState` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `addressPostalCode` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `websiteUrl` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `contactFirstName` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `contactSurname` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `stockExchange` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `stockSymbol` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `sampleMessages` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `messagesVolume` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `embeddedLink` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `embeddedPhone` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `ageGatedContent` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `directLending` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `optInConfirmationMessage` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `helpMessage` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `callToActionMessage` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `ein` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `fullCompanyAddress` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `smsCampaign` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
          - `answers` RcsBrandCampaignSenderDetailsQuestionnaireUSAnswersDto, required
            - `ownershipType` 'PRIVATE' | 'PUBLIC': Ownership type of the company. Not required for create, but required for launch.
            - `companyLegalName` string: The registered legal name of the company. Not required for create, but required for launch.
            - `companyPhoneNumber` string: The registered phone number of the company. Not required for create, but required for launch.
            - `companyEmailAddress` string, email: The email address of the company. Not required for create, but required for launch.
            - `brandName` string: Brand name or Doing Business As (DBA). Must be legally associated with the provided legal company name. Not required for create, but required for launch.
            - `brandIndustry` 'AGRICULTURE' | 'COMMUNICATION' | 'CONSTRUCTION' | 'EDUCATION' | 'ENERGY' | 'ENTERTAINMENT' | 'FINANCIAL' | 'GAMBLING' | 'GOVERNMENT' | 'HEALTHCARE' | 'HOSPITALITY' | 'HUMAN_RESOURCES' | 'INSURANCE' | 'LEGAL' | 'MANUFACTURING' | 'NON_GOVERNMENTAL_ORGANIZATION' | 'POLITICAL' | 'POSTAL' | 'PROFESSIONAL' | 'REAL_ESTATE' | 'RETAIL' | 'TECHNOLOGY' | 'TRANSPORTATION': Sector or industry of business. Not required for create, but required for launch.
            - `legalForm` 'CORPORATION' | 'LIMITED_LIABILITY_COMPANY' | 'PARTNERSHIP' | 'S_CORPORATION': Legal form of the company.
            - `taxIdCountry` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW': Country of the company's tax registration.
            - `taxId` string: Tax registration identifier associated with the provided legal company name.
            - `addressLine` string: Street address line. Not required for create, but required for launch.
            - `addressCity` string: City. Not required for create, but required for launch.
            - `addressCountry` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'XK' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW': Country of the company's tax registration.
            - `addressState` 'AK' | 'AL' | 'AR' | 'AS' | 'AZ' | 'CA' | 'CO' | 'CT' | 'DC' | 'DE' | 'FL' | 'GA' | 'GU' | 'HI' | 'IA' | 'ID' | 'IL' | 'IN' | 'KS' | 'KY' | 'LA' | 'MA' | 'MD' | 'ME' | 'MI' | 'MN' | 'MO' | 'MP' | 'MS' | 'MT' | 'NC' | 'ND' | 'NE' | 'NH' | 'NJ' | 'NM' | 'NV' | 'NY' | 'OH' | 'OK' | 'OR' | 'PA' | 'PR' | 'RI' | 'SC' | 'SD' | 'TN' | 'TX' | 'UT' | 'VA' | 'VI' | 'VT' | 'WA' | 'WI' | 'WV' | 'WY': State (US only). Not required for create, but required for launch.
            - `addressPostalCode` string: Postal code. Not required for create, but required for launch.
            - `websiteUrl` string: Primary website URL. Not required for create, but required for launch.
            - `contactFirstName` string: First name of the responsible contact person. Not required for create, but required for launch.
            - `contactSurname` string: Surname of the responsible contact person. Not required for create, but required for launch.
            - `stockExchange` string: Primary home country stock exchange abbreviation. Not required for create, but required for launch.
            - `stockSymbol` string: Primary home country stock symbol associated with stock exchange. Not required for create, but required for launch.
            - `sampleMessages` string[]: Sample messages for each use case or message type sent by the brand. Not required for create, but required for launch.
            - `messagesVolume` number: Messages volume. Not required for create, but required for launch.
            - `embeddedLink` boolean: Flag indicating if URL links will be embedded within message payloads.
            - `embeddedPhone` boolean: Flag indicating if phone numbers will be embedded within message payloads.
            - `ageGatedContent` boolean: Indicates if the campaign content is restricted by age (e.g., alcohol, tobacco).
            - `directLending` boolean: Indicates if the campaign involves direct financial lending, requiring stricter compliance.
            - `optInConfirmationMessage` string: Opt-in confirmation message sent to users. Not required for create, but required for launch.
            - `helpMessage` string: Help message of the campaign. Not required for create, but required for launch.
            - `callToActionMessage` string: Call to action message of the campaign. Not required for create, but required for launch.
        - object: SenderDetailsQuestionnaireUSDto is deprecated and will be removed in future versions. Please use BrandCampaignSenderDetailsQuestionnaireUSDto instead.
          - `questions` RcsSenderDetailsQuestionnaireUSQuestionsDto, required: SenderDetailsQuestionnaireUSQuestionsDto is deprecated and will be removed in future versions. Please use BrandCampaignSenderDetailsQuestionnaireUSQuestionsDto instead.
            - `companyLegalName` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `ein` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `brandIndustry` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `fullCompanyAddress` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `smsCampaign` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
            - `messagesVolume` RcsSenderDetailsQuestionnaireQuestionObjectDto, required
              - …
          - `answers` RcsSenderDetailsQuestionnaireUSAnswersDto, required: SenderDetailsQuestionnaireUSAnswersDto is deprecated and will be removed in future versions. Please use BrandCampaignSenderDetailsQuestionnaireUSAnswersDto instead.
            - `companyLegalName` string: The registered legal name of the company. Not required for create, but required for launch.
            - `ein` string: Employer Identification Number (EIN).
            - `brandIndustry` string: Sector or industry of business. Not required for create, but required for launch.
            - `fullCompanyAddress` string: Full company address.
            - `fullCompanyAddressMetadata` RcsSenderDetailsQuestionnaireAnswerMetadataDto
              - …
            - `smsCampaign` string: US SMS campaign used as fallback.
            - `messagesVolume` string: Messages volume. Not required for create, but required for launch.
  - `region` 'BR' | 'EU' | 'US', required: Region sender is provisioned in.
  - `billingCategory` 'CONVERSATIONAL' | 'NON_CONVERSATIONAL' | 'BASIC_MESSAGE' | 'CONVERSATIONAL_LEGACY' | 'SINGLE_MESSAGE', required: Billing category. Note: The billing framework distinguishes between two primary categories: non-conversational and conversational. The non-conversational category includes SINGLE_MESSAGE and BASIC_MESSAGE types which are considered functionally equivalent in the current revision. The conversational category includes CONVERSATIONAL and CONVERSATIONAL_LEGACY types. Values BASIC_MESSAGE, SINGLE_MESSAGE and CONVERSATIONAL_LEGACY are deprecated and will be removed in a future version. - CONVERSATIONAL: Designed for longer, more complex sessions where the user and brand exchange a series of messages. - NON_CONVERSATIONAL: Represents a non-conversational billing category, which replaces the legacy SINGLE_MESSAGE and BASIC_MESSAGE categories. This is for agents that primarily engage in one-way (A2P) communication. - BASIC_MESSAGE: Billing model is similar to SMS. Deprecated value, use NON_CONVERSATIONAL instead. - CONVERSATIONAL_LEGACY: Legacy category to support the billing configuration of existing agents. Deprecated value, use CONVERSATIONAL instead. - SINGLE_MESSAGE: Replaces SMS with a richer messaging experience. Deprecated value, use NON_CONVERSATIONAL instead.
  - `useCase` 'MULTIUSE' | 'OTP' | 'PROMOTIONAL' | 'TRANSACTIONAL', required: Use case.
  - `hostingRegion` 'ASIA_PACIFIC' | 'EUROPE' | 'NORTH_AMERICA', required: Internal Google hosting region
  - `authName` string: The name is needed to connect the sender to a Conversation API App.
  - `authToken` string: The token is needed to connect the sender to a Conversation API App.
  - `created` string: The UTC Date Time in ISO 8601 for when the sender was created.
  - `modified` string: The UTC Date Time in ISO 8601 for when the sender was last modified.
  - `supplierDetails` RcsSupplierDetailsDto
    - `google` RcsSupplierDetailsGoogleDto
      - `agentId` string: Google agent id.
      - `brandId` string: Google brand id.
  - `launched` string: The UTC Date Time in ISO 8601 for when the sender was last launched.
  - `brandDetails` RcsBrandRegistrationDto
    - `id` string, required: Unique identifier for the brand registration.
    - `status` 'ARCHIVED' | 'COMPLETED' | 'DRAFT' | 'UNRECOGNIZED' | 'UNSPECIFIED', required: Current status of the brand registration.
    - `registration` RcsBrandRegistrationProcessDto, required
      - `id` string, required: Unique identifier for the brand registration process.
      - `status` 'ARCHIVED' | 'COMPLETED' | 'INCOMPLETE' | 'MANUAL_REVIEW' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'UNRECOGNIZED' | 'UNSPECIFIED', required: Current status of the brand registration process.
  - `campaignDetails` RcsCampaignRegistrationDto
    - `id` string, required: Unique identifier for the campaign registration (campaign hub).
    - `campaignName` string, required: The user-assigned name of the campaign.
    - `requestId` string, required: Unique request correlation/tracking identifier.

## Other responses

- `400`: BadRequest
- `401`: Unauthorized
- `403`: Forbidden
- `404`: NotFound
- `409`: Conflict
- `412`: PreconditionFailed
- `429`: TooManyRequests
- `500`: InternalServerError

## Changes

> 17 revisions in range; 1 not diffed.

- **2026-10-05** `30f63d8c2864`: 2 warning
  - added the new `EXPIRED` enum value to the `testNumberStates/items/state/allOf[#/components/schemas/RcsTestNumberStatesEnum]/` response property for the response status `200`
  - added the new `FAILED` enum value to the `testNumberStates/items/state/allOf[#/components/schemas/RcsTestNumberStatesEnum]/` response property for the response status `200`
- **2026-09-17** `cb49a3396ef4`: 1 breaking
  - added `#/components/schemas/RcsDefaultSenderDetailsQuestionnaireUSDto` to the `details/allOf[#/components/schemas/RcsSenderDetailsDto]/questionnaire/allOf[#/components/schemas/RcsSenderDetailsQuestionnaireDto]/us` response property `oneOf` list for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/sinch/apis/provisioning-api/changes/v1/projects/:projectId/rcs/senders/:senderId/launch/post.md)

---

[API](https://skmtc.dev/sinch/apis/provisioning-api.md) - [All operations](https://skmtc.dev/sinch/apis/provisioning-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinch/apis/provisioning-api/revisions/90d78b3a8575?raw)
