openapi: 3.2.0 info: title: Provisioning WhatsApp Accounts API description: The WhatsApp accounts endpoint lets you create and update WhatsApp accounts as well as get account activity and leave comments. version: 1.2.117 servers: - url: https://provisioning.api.sinch.com description: Production server security: - BasicAuth: [] BearerAuth: [] OAuth2Production: [] tags: - name: WhatsApp Accounts description: The WhatsApp accounts endpoint lets you create and update WhatsApp accounts as well as get account activity and leave comments. paths: /v1/projects/{projectId}/whatsapp: get: description: Returns an account for a project. operationId: WhatsappAccountsController_getAccount_v1 parameters: - name: projectId required: true in: path description: The unique ID of the project. You can find this on the Sinch Dashboard. schema: type: string responses: '200': description: Account content: application/json: schema: $ref: '#/components/schemas/WhatsappAccountDto' examples: response: summary: Get response description: "\n Response with an account.\n " value: state: ONBOARDED isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false wabaEnabledForInsights: false wabaEnabledForDirectSend: false compatibleRegions: - eu - us currency: EUR '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: unauthorized_error-0: summary: UnauthorizedErrorError value: errorCode: unauthorized_error message: Unauthorized error. resolution: Verify that projectId is correct. '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_not_found-0: summary: AccountNotFoundError value: errorCode: account_not_found message: Account not found. resolution: Verify that the parameters are correct. '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_data_is_corrupt-0: summary: AccountDataIsCorruptError value: errorCode: account_data_is_corrupt message: Account data is corrupt. resolution: Please contact support. '500': description: InternalServerError content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: internal_error-0: summary: InternalErrorError value: errorCode: internal_error message: Internal server error. resolution: Please wait and try again, if the error persist please contact support. summary: Get account for project tags: - WhatsApp Accounts x-badges: - name: GA position: after color: green post: callbacks: Comment: '{$request.body#webhooks.target}': post: summary: Comment on account description: "\n Received when a comment has been added to the account.\n " parameters: - in: header name: x-sinch-webhook-signature schema: type: string format: SHA256-hash example: Jc88RMjzkxPoy/fCPiL+iy7osojuUgawpjl1g6H38O8= - in: header name: x-sinch-webhook-signature-algorithm schema: type: string const: HmacSHA256 x-enumDescriptions: HmacSHA256: The HMAC SHA-256 signature algorithm used to validate webhook authenticity. uniqueItems: false example: HmacSHA256 - in: header name: x-sinch-webhook-signature-nonce schema: type: string example: 01EAW2BNWCG9DC13RS582V0ZQ3 - in: header name: x-sinch-webhook-signature-timestamp schema: type: string format: timestamp example: '1592227387' requestBody: content: application/json: schema: type: object properties: type: description: Type of event in this case `WHATSAPP_ACCOUNT_COMMENT_ADDED`. type: string payload: description: Account at time of callback. allOf: - $ref: '#/components/schemas/WhatsappAccountDto' comment: description: Comment for account. type: string required: - type - payload - comment example: type: WHATSAPP_ACCOUNT_COMMENT_ADDED payload: state: ONBOARDED isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false wabaEnabledForInsights: false wabaEnabledForDirectSend: false compatibleRegions: - eu - us currency: EUR comment: Example comment responses: '200': description: Response to callback will be ignored. The call will retry if unsuccessful. Onboard: '{$request.body#webhooks.target}': post: summary: Account onboarded description: "\n Received when an Account is onboarded.\n " parameters: - in: header name: x-sinch-webhook-signature schema: type: string format: SHA256-hash example: Jc88RMjzkxPoy/fCPiL+iy7osojuUgawpjl1g6H38O8= - in: header name: x-sinch-webhook-signature-algorithm schema: type: string const: HmacSHA256 x-enumDescriptions: HmacSHA256: The HMAC SHA-256 signature algorithm used to validate webhook authenticity. uniqueItems: false example: HmacSHA256 - in: header name: x-sinch-webhook-signature-nonce schema: type: string example: 01EAW2BNWCG9DC13RS582V0ZQ3 - in: header name: x-sinch-webhook-signature-timestamp schema: type: string format: timestamp example: '1592227387' requestBody: content: application/json: schema: type: object properties: type: description: Type of event in this case `WHATSAPP_ACCOUNT_ONBOARDED`. type: string payload: description: Account at time of callback. allOf: - $ref: '#/components/schemas/WhatsappAccountDto' comment: description: Comment for account. type: string required: - type - payload example: type: WHATSAPP_ACCOUNT_ONBOARDED payload: state: ONBOARDED isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false wabaEnabledForInsights: false wabaEnabledForDirectSend: false compatibleRegions: - eu - us currency: EUR responses: '200': description: Response to callback will be ignored. The call will retry if unsuccessful. Rejected: '{$request.body#webhooks.target}': post: summary: Account rejected description: "\n Received when an Account is rejected.\n " parameters: - in: header name: x-sinch-webhook-signature schema: type: string format: SHA256-hash example: Jc88RMjzkxPoy/fCPiL+iy7osojuUgawpjl1g6H38O8= - in: header name: x-sinch-webhook-signature-algorithm schema: type: string const: HmacSHA256 x-enumDescriptions: HmacSHA256: The HMAC SHA-256 signature algorithm used to validate webhook authenticity. uniqueItems: false example: HmacSHA256 - in: header name: x-sinch-webhook-signature-nonce schema: type: string example: 01EAW2BNWCG9DC13RS582V0ZQ3 - in: header name: x-sinch-webhook-signature-timestamp schema: type: string format: timestamp example: '1592227387' requestBody: content: application/json: schema: type: object properties: type: description: Type of event in this case `WHATSAPP_ACCOUNT_REJECTED`. type: string payload: description: Account at time of callback. allOf: - $ref: '#/components/schemas/WhatsappAccountDto' comment: description: Comment for account. type: string required: - type - payload example: type: WHATSAPP_ACCOUNT_REJECTED payload: isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' changes: status: REJECTED details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false compatibleRegions: - eu - us responses: '200': description: Response to callback will be ignored. The call will retry if unsuccessful. PendingVerification: '{$request.body#webhooks.target}': post: summary: Account pending verification description: "\n Received when an Account is in pending verification.\n " parameters: - in: header name: x-sinch-webhook-signature schema: type: string format: SHA256-hash example: Jc88RMjzkxPoy/fCPiL+iy7osojuUgawpjl1g6H38O8= - in: header name: x-sinch-webhook-signature-algorithm schema: type: string const: HmacSHA256 x-enumDescriptions: HmacSHA256: The HMAC SHA-256 signature algorithm used to validate webhook authenticity. uniqueItems: false example: HmacSHA256 - in: header name: x-sinch-webhook-signature-nonce schema: type: string example: 01EAW2BNWCG9DC13RS582V0ZQ3 - in: header name: x-sinch-webhook-signature-timestamp schema: type: string format: timestamp example: '1592227387' requestBody: content: application/json: schema: type: object properties: type: description: Type of event in this case `WHATSAPP_ACCOUNT_PENDING_VERIFICATION`. type: string payload: description: Account at time of callback. allOf: - $ref: '#/components/schemas/WhatsappAccountDto' comment: description: Comment for account. type: string required: - type - payload example: type: WHATSAPP_ACCOUNT_PENDING_VERIFICATION payload: isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' changes: status: PENDING_FACEBOOK_VERIFICATION details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false compatibleRegions: - eu - us responses: '200': description: Response to callback will be ignored. The call will retry if unsuccessful. BusinessDailyLimitChanged: '{$request.body#webhooks.target}': post: summary: Account daily limit changed description: "\n Received when Account daily limit has been changed by Meta.\n " parameters: - in: header name: x-sinch-webhook-signature schema: type: string format: SHA256-hash example: Jc88RMjzkxPoy/fCPiL+iy7osojuUgawpjl1g6H38O8= - in: header name: x-sinch-webhook-signature-algorithm schema: type: string const: HmacSHA256 x-enumDescriptions: HmacSHA256: The HMAC SHA-256 signature algorithm used to validate webhook authenticity. uniqueItems: false example: HmacSHA256 - in: header name: x-sinch-webhook-signature-nonce schema: type: string example: 01EAW2BNWCG9DC13RS582V0ZQ3 - in: header name: x-sinch-webhook-signature-timestamp schema: type: string format: timestamp example: '1592227387' requestBody: content: application/json: schema: type: object properties: type: description: Type of event in this case `WHATSAPP_ACCOUNT_DAILY_LIMIT_CHANGED`. type: string payload: description: Account at time of callback. allOf: - $ref: '#/components/schemas/WhatsappAccountDto' comment: description: Comment for account. type: string required: - type - payload example: type: WHATSAPP_ACCOUNT_DAILY_LIMIT_CHANGED payload: state: ONBOARDED isEmbeddedSignup: false businessManager: SINCH_BR wabaId: '1234567890' details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false wabaEnabledForInsights: true wabaEnabledForDirectSend: false compatibleRegions: - br primaryBusinessLocation: BR currency: EUR responses: '200': description: Response to callback will be ignored. The call will retry if unsuccessful. WabaInformationChanged: '{$request.body#webhooks.target}': post: summary: Account business information changed description: "\n Received when Account has some of its business information changed by Meta.\n " parameters: - in: header name: x-sinch-webhook-signature schema: type: string format: SHA256-hash example: Jc88RMjzkxPoy/fCPiL+iy7osojuUgawpjl1g6H38O8= - in: header name: x-sinch-webhook-signature-algorithm schema: type: string const: HmacSHA256 x-enumDescriptions: HmacSHA256: The HMAC SHA-256 signature algorithm used to validate webhook authenticity. uniqueItems: false example: HmacSHA256 - in: header name: x-sinch-webhook-signature-nonce schema: type: string example: 01EAW2BNWCG9DC13RS582V0ZQ3 - in: header name: x-sinch-webhook-signature-timestamp schema: type: string format: timestamp example: '1592227387' requestBody: content: application/json: schema: type: object properties: type: description: Type of event in this case `WHATSAPP_WABA_ACCOUNT_CHANGED`. type: string payload: description: Account at time of callback. allOf: - $ref: '#/components/schemas/WhatsappAccountDto' comment: description: Comment for account. type: string required: - type - payload example: type: WHATSAPP_WABA_ACCOUNT_CHANGED payload: state: ONBOARDED isEmbeddedSignup: false businessManager: SINCH_BR wabaId: '1234567890' details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false wabaEnabledForInsights: true wabaEnabledForDirectSend: false compatibleRegions: - br primaryBusinessLocation: BR currency: EUR responses: '200': description: Response to callback will be ignored. The call will retry if unsuccessful. description: Create the WhatsApp account for the project. Each project can only have one account. operationId: WhatsappAccountsController_createAccount_v1 parameters: - name: projectId required: true in: path description: The unique ID of the project. You can find this on the Sinch Dashboard. schema: type: string requestBody: required: true description: Account data content: application/json: schema: oneOf: - $ref: '#/components/schemas/WhatsappInputAccountPartnerInitiatedDto' - $ref: '#/components/schemas/WhatsappInputAccountDtoDeprecated' examples: input: summary: Body request description: "\n Example body request to create an account.\n " value: companyLegalName: Legal name of company clientBusinessManagerId: '1234567890' partnerInitiated: summary: Body request - Partner Initiated description: "\n Example body request to create a partner-initiated account.\n " value: clientBusinessManagerId: '1234567890' businessManager: SINCH_UK wabaName: Legal name of company senderDetails: displayName: My Sender Name businessCategory: OTC_DRUGS region: EU metaLocalStorage: BH responses: '201': description: Account content: application/json: schema: $ref: '#/components/schemas/WhatsappAccountDto' examples: pending: summary: Create response description: "\n Response when successfully creating an account.\n " value: isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' changes: status: IN_PROGRESS details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false compatibleRegions: - eu - us onboarded: summary: Create response description: "\n Response when successfully created an account.\n " value: state: ONBOARDED isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false wabaEnabledForInsights: false wabaEnabledForDirectSend: false compatibleRegions: - eu - us currency: EUR '400': description: BadRequest content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: invalid_input-0: summary: InvalidInputError value: errorCode: invalid_input message: Invalid input. resolution: Correct the validation errors and submit again. additionalInformation: validationErrors: - companyLegalName must be a string invalid_business_manager_for_environment-1: summary: InvalidBusinessManagerForEnvironmentError value: errorCode: invalid_business_manager_for_environment message: Invalid business manager for environment. resolution: Verify that business manager is valid for environment. Allowed business managers for environment SINCH_AMERICA, SINCH_UK. invalid_payload-2: summary: InvalidPayloadError value: errorCode: invalid_payload message: Invalid payload. resolution: Correct payload and submit again. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: unauthorized_error-0: summary: UnauthorizedErrorError value: errorCode: unauthorized_error message: Unauthorized error. resolution: Verify that projectId is correct. '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: project_not_found-0: summary: ProjectNotFoundError value: errorCode: project_not_found message: Project not found. resolution: Verify that the projectId is correct. '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_exists-0: summary: AccountExistsError value: errorCode: account_exists message: Account already exists. resolution: There can only be one WhatsApp account for each project. Choose another one project to create a new WhatsApp account. account_data_is_corrupt-1: summary: AccountDataIsCorruptError value: errorCode: account_data_is_corrupt message: Account data is corrupt. resolution: Please contact support. '500': description: InternalServerError content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: internal_error-0: summary: InternalErrorError value: errorCode: internal_error message: Internal server error. resolution: Please wait and try again, if the error persist please contact support. summary: Create account for project tags: - WhatsApp Accounts x-badges: - name: GA position: after color: green delete: description: 'Deletes the account for a project. Deleting an account is only possible if there is no sender assigned to the account.' operationId: WhatsappAccountsController_deleteAccount_v1 parameters: - name: projectId required: true in: path description: The unique ID of the project. You can find this on the Sinch Dashboard. schema: type: string responses: '204': description: Account deleted '400': description: BadRequest content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: project_not_initialized-0: summary: ProjectNotInitializedError value: errorCode: project_not_initialized message: Project not initialized for WhatsApp. resolution: Verify that the project ID is correct and that it has been onboarded for WhatsApp. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: unauthorized_error-0: summary: UnauthorizedErrorError value: errorCode: unauthorized_error message: Unauthorized error. resolution: Verify that projectId is correct. '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_has_senders-0: summary: AccountHasSendersError value: errorCode: account_has_senders message: Account has senders. resolution: Delete senders before deleting the account. additionalInformation: projectId: 6a13764f-97ab-4584-b7f2-4b2d11a0ce59 senderIds: - 437f8791-69ec-42af-9271-59b86b80178d - 62550a35-2307-4ff1-86e4-41b0cbc7b7cb account_has_sender_changes-1: summary: AccountHasSenderChangesError value: errorCode: account_has_sender_changes message: Account has pending sender changes. resolution: All sender changes must be resolved before deleting the account. If the error persists, please contact support. additionalInformation: projectId: 6a13764f-97ab-4584-b7f2-4b2d11a0ce59 '500': description: InternalServerError content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: template_could_not_delete_drafts-0: summary: TemplateCouldNotDeleteDraftsError value: errorCode: template_could_not_delete_drafts message: Couldn't delete template drafts. resolution: Please try again later, if the error persists, please contact support. internal_error-1: summary: InternalErrorError value: errorCode: internal_error message: Internal server error. resolution: Please wait and try again, if the error persist please contact support. summary: Delete account for project tags: - WhatsApp Accounts x-badges: - name: Closed Beta position: after color: red patch: description: 'Update an account. It is only possible to update an account that has been rejected. After update the status will be set to `IN_PROGRESS`.' operationId: WhatsappAccountsController_updateAccount_v1 parameters: - name: projectId required: true in: path description: The unique ID of the project. You can find this on the Sinch Dashboard. schema: type: string requestBody: required: true description: Supported account fields to update. content: application/json: schema: $ref: '#/components/schemas/WhatsappInputUpdateAccountDto' examples: input: summary: Body request description: "\n Example body request to update an account.\n " value: companyLegalName: Updated legal name of company wabaName: Updated legal name of company clientBusinessManagerId: '1234567890' partnerInitiated: summary: Body request - Partner Initiated description: "\n Example body request to update an account using Partner Initiated flow.\n " value: companyLegalName: Updated legal name of company wabaName: Updated legal name of company clientBusinessManagerId: '1234567890' senderDetails: displayName: Updated display name businessCategory: NON_PROFIT region: BR metaLocalStorage: AE responses: '200': description: Account content: application/json: schema: $ref: '#/components/schemas/WhatsappAccountDto' examples: response: summary: Update response description: "\n Response when successfully update an account.\n " value: state: REJECTED isEmbeddedSignup: false businessManager: SINCH_UK wabaId: '1234567890' changes: status: IN_PROGRESS details: companyLegalName: Update legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' details: companyLegalName: Legal name of company wabaName: Legal name of company clientBusinessManagerId: '1234567890' wabaMaxPriceOnboarded: false wabaEnabledForInsights: true wabaEnabledForDirectSend: false compatibleRegions: - eu - us '400': description: BadRequest content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: invalid_input-0: summary: InvalidInputError value: errorCode: invalid_input message: Invalid input. resolution: Correct the validation errors and submit again. additionalInformation: validationErrors: - wabaName must be a string no_fields_to_update-1: summary: NoFieldsToUpdateError value: errorCode: no_fields_to_update message: No fields to be updated. resolution: Supply at least one field to be updated. no_fields_to_update-2: summary: NoFieldsToUpdateError value: errorCode: no_fields_to_update message: No fields to be updated. resolution: Supply at least one field to be updated. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: unauthorized_error-0: summary: UnauthorizedErrorError value: errorCode: unauthorized_error message: Unauthorized error. resolution: Verify that projectId is correct. '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_not_found-0: summary: AccountNotFoundError value: errorCode: account_not_found message: Account not found. resolution: Verify that the parameters are correct. '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_not_updatable-0: summary: AccountNotUpdatableError value: errorCode: account_not_updatable message: Account is not updatable. resolution: Only account that are in "REJECTED" state can be updated. '500': description: InternalServerError content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: internal_error-0: summary: InternalErrorError value: errorCode: internal_error message: Internal server error. resolution: Please wait and try again, if the error persist please contact support. summary: Update account for project tags: - WhatsApp Accounts x-badges: - name: GA position: after color: green /v1/projects/{projectId}/whatsapp/activities: get: description: Lists activities on account from the most recent one to the oldest one. operationId: WhatsappAccountsController_listActivities_v1 parameters: - name: projectId required: true in: path description: The unique ID of the project. You can find this on the Sinch Dashboard. schema: type: string - name: pageToken required: false in: query schema: type: string description: The page token if retrieving the next page from a previous query. - name: pageSize required: false in: query schema: type: number minimum: 1 maximum: 100 description: The page size requested. responses: '200': description: Recent activities on account content: application/json: schema: $ref: '#/components/schemas/WhatsappAccountNotificationListDto' examples: response: summary: List account activities response description: "\n Response for all account activities.\n " value: totalSize: 2 pageSize: 50 notifications: - type: CREATED created: '2023-01-19T13:11:08.204Z' author: Provisioning API user - type: COMMENT_ADDED created: '2023-01-19T13:11:08.204Z' comment: Example comment author: Provisioning API user '400': description: BadRequest content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: invalid_page_token-0: summary: InvalidPageTokenError value: errorCode: invalid_page_token message: Invalid page token. resolution: The page token to use is provided in the previous query response, for new queries simply leave this field undefined. invalid_page_size-1: summary: InvalidPageSizeError value: errorCode: invalid_page_size message: Page size must be numeric. resolution: Use a integer value for pageSize parameter. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: unauthorized_error-0: summary: UnauthorizedErrorError value: errorCode: unauthorized_error message: Unauthorized error. resolution: Verify that projectId is correct. '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_not_found-0: summary: AccountNotFoundError value: errorCode: account_not_found message: Account not found. resolution: Verify that the parameters are correct. '500': description: InternalServerError content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: internal_error-0: summary: InternalErrorError value: errorCode: internal_error message: Internal server error. resolution: Please wait and try again, if the error persist please contact support. summary: Lists activities on account tags: - WhatsApp Accounts x-badges: - name: GA position: after color: green /v1/projects/{projectId}/whatsapp/comments: post: description: Creates a comment for an account. operationId: WhatsappAccountsController_createComment_v1 parameters: - name: projectId required: true in: path description: The unique ID of the project. You can find this on the Sinch Dashboard. schema: type: string requestBody: required: true description: Comment data content: application/json: schema: $ref: '#/components/schemas/WhatsappCommentInputDto' examples: input: summary: Body request description: "\n Example body request to create a comment.\n " value: comment: Example comment. responses: '201': description: Created comment for an account. content: application/json: schema: $ref: '#/components/schemas/WhatsappCommentDto' examples: created: summary: Create response description: "\n Response when successfully creating a comment.\n " value: type: CREATED comment: Example comment created: '2023-01-19T13:11:08.204Z' '400': description: BadRequest content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: invalid_input-0: summary: InvalidInputError value: errorCode: invalid_input message: Invalid input. resolution: Correct the validation errors and submit again. additionalInformation: validationErrors: - comment must be longer than or equal to 1 characters invalid_payload-1: summary: InvalidPayloadError value: errorCode: invalid_payload message: Invalid payload. resolution: Correct payload and submit again. '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: unauthorized_error-0: summary: UnauthorizedErrorError value: errorCode: unauthorized_error message: Unauthorized error. resolution: Verify that projectId is correct. '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_not_found-0: summary: AccountNotFoundError value: errorCode: account_not_found message: Account not found. resolution: Verify that the parameters are correct. '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: account_data_is_corrupt-0: summary: AccountDataIsCorruptError value: errorCode: account_data_is_corrupt message: Account data is corrupt. resolution: Please contact support. '500': description: InternalServerError content: application/json: schema: $ref: '#/components/schemas/WhatsappPapiErrorDto' examples: internal_error-0: summary: InternalErrorError value: errorCode: internal_error message: Internal server error. resolution: Please wait and try again, if the error persist please contact support. summary: Creates a comment for an account tags: - WhatsApp Accounts x-badges: - name: GA position: after color: green components: schemas: WhatsappSenderInputMetaLocalStoragesEnum: type: string enum: - AE - AU - BH - BR - CA - CH - DE - GB - ID - IN - JP - KR - SG - US - ZA description: Region sender store the data in Meta. If not provided, the default value set for the chosen region will be used. WhatsappCommentInputDto: type: object properties: comment: type: string minLength: 1 maxLength: 65535 uniqueItems: false required: - comment WhatsappCommentTypeEnum: type: string const: CREATED WhatsappSenderWhatsAppVerticalEnum: type: string enum: - ALCOHOL - AUTOMOTIVE - BEAUTY_SPA_SALON - CLOTHING_AND_APPAREL - EDUCATION - ENTERTAINMENT - EVENT_PLANNING_AND_SERVICE - FINANCE_AND_BANKING - FOOD_AND_GROCERY - HOTEL_AND_LODGING - MEDICAL_AND_HEALTH - NON_PROFIT - NOT_SET - ONLINE_GAMBLING - OTC_DRUGS - OTHER - PHYSICAL_GAMBLING - PROFESSIONAL_SERVICES - PUBLIC_SERVICE - RESTAURANT - SHOPPING_AND_RETAIL - TRAVEL_AND_TRANSPORTATION - UNRECOGNIZED description: Category of the sender displayed in the Business Info within WhatsApp. WhatsappAccountChangeStateEnum: type: string enum: - DRAFT - IN_PROGRESS - PENDING_FACEBOOK_VERIFICATION - REJECTED description: Current status of the pending changes. WhatsappInputAccountPartnerInitiatedDto: type: object properties: wabaName: type: string minLength: 1 maxLength: 255 description: 'The registered name of the brand who will be engaging with their users needs to be specified. This name must match the name associated with the Facebook Business Manager ID below. You can verify the registered name by visiting: https://business.facebook.com/select/?business_id= Ensure that the name shown exactly matches the one you enter here.' uniqueItems: false clientBusinessManagerId: type: string minLength: 1 maxLength: 255 description: The Business Manager ID for the client to create the account. This can be found in the Meta Business Manager in Business Settings > Business Info below the Business Manager Account Name. uniqueItems: false businessManager: x-enumDescriptions: SINCH_AMERICA: Associates the input configuration with the Sinch America Meta Business Manager account. SINCH_BR: Associates the input configuration with the Sinch Brazil Meta Business Manager account. SINCH_MX: Associates the input configuration with the Sinch Mexico Meta Business Manager account. SINCH_SEP: Associates the input configuration with the Sinch SEP Meta Business Manager account. SINCH_UK: Associates the input configuration with the Sinch UK Meta Business Manager account. description: Business manager. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappInputBusinessManagersEnum' senderDetails: description: Details of the sender to be created. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappInputAccountSenderRelatedDetailsDto' required: - wabaName - clientBusinessManagerId - senderDetails WhatsappConversationAppRegionsEnum: type: string enum: - br - eu - us description: Conversation API app regions the sender can be used for. WhatsappInputAccountDtoDeprecated: type: object properties: clientBusinessManagerId: type: string minLength: 1 maxLength: 255 description: The Business Manager ID for the client to create the account. This can be found in the Meta Business Manager in Business Settings > Business Info below the Business Manager Account Name. uniqueItems: false businessManager: x-enumDescriptions: SINCH_AMERICA: Associates the input configuration with the Sinch America Meta Business Manager account. SINCH_BR: Associates the input configuration with the Sinch Brazil Meta Business Manager account. SINCH_MX: Associates the input configuration with the Sinch Mexico Meta Business Manager account. SINCH_SEP: Associates the input configuration with the Sinch SEP Meta Business Manager account. SINCH_UK: Associates the input configuration with the Sinch UK Meta Business Manager account. description: Business manager. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappInputBusinessManagersEnum' companyLegalName: type: string minLength: 1 maxLength: 255 description: 'The registered name of the brand who will be engaging with their users needs to be specified. This name must match the name associated with the Facebook Business Manager ID below. You can verify the registered name by visiting: https://business.facebook.com/select/?business_id= Ensure that the name shown exactly matches the one you enter here.' uniqueItems: false description: InputAccountDto is deprecated as Meta officially has declared End-Of-Life (EOL) of OBO on September 30, 2025. required: - clientBusinessManagerId - companyLegalName WhatsappSenderMetaLocalStoragesEnum: type: string enum: - AE - AU - BH - BR - CA - CH - DE - GB - ID - IN - JP - KR - SG - US - ZA - UNRECOGNIZED - UNSPECIFIED description: Region sender store the data in Meta. WhatsappSenderBotRegionEnum: type: string enum: - BR - EU - US - UNRECOGNIZED description: Region sender is provisioned in. WhatsappAccountSenderRelatedDetailsDto: type: object properties: displayName: type: string description: Waba display name / used as default display name of new phone at Meta uniqueItems: false businessCategory: x-enumDescriptions: ALCOHOL: The brand operates within the alcohol sector. AUTOMOTIVE: The brand operates within the automotive sector. BEAUTY_SPA_SALON: The brand operates within beauty, spa, or salon services. CLOTHING_AND_APPAREL: The brand operates within clothing and apparel commerce. EDUCATION: The brand operates within the education field. ENTERTAINMENT: The brand operates within the entertainment and media industry. EVENT_PLANNING_AND_SERVICE: The brand operates within event planning and corporate services. FINANCE_AND_BANKING: The brand operates within financial and banking services. FOOD_AND_GROCERY: The brand operates within the food supply or grocery sector. HOTEL_AND_LODGING: The brand operates within hospitality, hotels, or lodging. MEDICAL_AND_HEALTH: The brand operates within healthcare, medical services, or pharmaceuticals. NON_PROFIT: The brand is a registered non-profit organization. NOT_SET: The operational business vertical has not been selected. ONLINE_GAMBLING: The brand operates within the online gambling or betting industry. OTC_DRUGS: The brand operates within over-the-counter drug sales and distribution. OTHER: The brand operates in an industry outside the standard defined taxonomy. PHYSICAL_GAMBLING: The brand operates within physical gambling establishments or casinos. PROFESSIONAL_SERVICES: The brand provides corporate, professional, or technical services. PUBLIC_SERVICE: The brand provides public utilities or governmental services. RESTAURANT: The brand operates a restaurant or food service establishment. SHOPPING_AND_RETAIL: The brand operates within retail or wholesale commerce. TRAVEL_AND_TRANSPORTATION: The brand operates within transportation, travel, or logistics services. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Vertical / business category for the business account. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderWhatsAppVerticalEnum' region: x-enumDescriptions: BR: Specifies that the bot infrastructure should be hosted within the Brazil region. EU: Specifies that the bot infrastructure should be hosted within the Europe region. US: Specifies that the bot infrastructure should be hosted within the United States region. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Region for the partner-initiated sender. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderBotRegionEnum' metaLocalStorage: x-enumDescriptions: AE: Specifies that Meta-managed user and compliance data should be stored within the United Arab Emirates. AU: Specifies that Meta-managed user and compliance data should be stored within Australia. BH: Specifies that Meta-managed user and compliance data should be stored within Bahrain. BR: Specifies that Meta-managed user and compliance data should be stored within Brazil. CA: Specifies that Meta-managed user and compliance data should be stored within Canada. CH: Specifies that Meta-managed user and compliance data should be stored within Switzerland. DE: Specifies that Meta-managed user and compliance data should be stored within Germany. GB: Specifies that Meta-managed user and compliance data should be stored within the United Kingdom. ID: Specifies that Meta-managed user and compliance data should be stored within Indonesia. IN: Specifies that Meta-managed user and compliance data should be stored within India. JP: Specifies that Meta-managed user and compliance data should be stored within Japan. KR: Specifies that Meta-managed user and compliance data should be stored within South Korea. SG: Specifies that Meta-managed user and compliance data should be stored within Singapore. US: Specifies that Meta-managed user and compliance data should be stored within the United States. ZA: Specifies that Meta-managed user and compliance data should be stored within South Africa. UNSPECIFIED: The Meta data storage residency location is unspecified. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Local storage region for the partner-initiated sender. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderMetaLocalStoragesEnum' required: - displayName - businessCategory - region - metaLocalStorage WhatsappAccountSenderRelatedChangesDetailsDto: type: object properties: displayName: type: string minLength: 1 maxLength: 255 description: Waba display name / used as default display name of new phone at Meta uniqueItems: false businessCategory: x-enumDescriptions: ALCOHOL: The brand operates within the alcohol sector. AUTOMOTIVE: The brand operates within the automotive sector. BEAUTY_SPA_SALON: The brand operates within beauty, spa, or salon services. CLOTHING_AND_APPAREL: The brand operates within clothing and apparel commerce. EDUCATION: The brand operates within the education field. ENTERTAINMENT: The brand operates within the entertainment and media industry. EVENT_PLANNING_AND_SERVICE: The brand operates within event planning and corporate services. FINANCE_AND_BANKING: The brand operates within financial and banking services. FOOD_AND_GROCERY: The brand operates within the food supply or grocery sector. HOTEL_AND_LODGING: The brand operates within hospitality, hotels, or lodging. MEDICAL_AND_HEALTH: The brand operates within healthcare, medical services, or pharmaceuticals. NON_PROFIT: The brand is a registered non-profit organization. NOT_SET: The operational business vertical has not been selected. ONLINE_GAMBLING: The brand operates within the online gambling or betting industry. OTC_DRUGS: The brand operates within over-the-counter drug sales and distribution. OTHER: The brand operates in an industry outside the standard defined taxonomy. PHYSICAL_GAMBLING: The brand operates within physical gambling establishments or casinos. PROFESSIONAL_SERVICES: The brand provides corporate, professional, or technical services. PUBLIC_SERVICE: The brand provides public utilities or governmental services. RESTAURANT: The brand operates a restaurant or food service establishment. SHOPPING_AND_RETAIL: The brand operates within retail or wholesale commerce. TRAVEL_AND_TRANSPORTATION: The brand operates within transportation, travel, or logistics services. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Vertical / business category for the business account. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderWhatsAppVerticalEnum' region: x-enumDescriptions: BR: Specifies that the bot infrastructure should be hosted within the Brazil region. EU: Specifies that the bot infrastructure should be hosted within the Europe region. US: Specifies that the bot infrastructure should be hosted within the United States region. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Region for the partner-initiated sender. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderBotRegionEnum' metaLocalStorage: x-enumDescriptions: AE: Specifies that Meta-managed user and compliance data should be stored within the United Arab Emirates. AU: Specifies that Meta-managed user and compliance data should be stored within Australia. BH: Specifies that Meta-managed user and compliance data should be stored within Bahrain. BR: Specifies that Meta-managed user and compliance data should be stored within Brazil. CA: Specifies that Meta-managed user and compliance data should be stored within Canada. CH: Specifies that Meta-managed user and compliance data should be stored within Switzerland. DE: Specifies that Meta-managed user and compliance data should be stored within Germany. GB: Specifies that Meta-managed user and compliance data should be stored within the United Kingdom. ID: Specifies that Meta-managed user and compliance data should be stored within Indonesia. IN: Specifies that Meta-managed user and compliance data should be stored within India. JP: Specifies that Meta-managed user and compliance data should be stored within Japan. KR: Specifies that Meta-managed user and compliance data should be stored within South Korea. SG: Specifies that Meta-managed user and compliance data should be stored within Singapore. US: Specifies that Meta-managed user and compliance data should be stored within the United States. ZA: Specifies that Meta-managed user and compliance data should be stored within South Africa. UNSPECIFIED: The Meta data storage residency location is unspecified. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Local storage region for the partner-initiated sender. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderMetaLocalStoragesEnum' required: - displayName - businessCategory - region - metaLocalStorage WhatsappAccountChangesDto: type: object properties: status: x-enumDescriptions: DRAFT: The modifications to the account profile are saved as a draft only. IN_PROGRESS: The modifications to the account profile have been submitted and are still processing. PENDING_FACEBOOK_VERIFICATION: The modifications to the account profile await completed Facebook business verification workflows. REJECTED: The modifications to the account profile have been reviewed and rejected. description: Current status of the pending changes. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappAccountChangeStateEnum' details: anyOf: - $ref: '#/components/schemas/WhatsappAccountDetailsDto' description: For newly created account - $ref: '#/components/schemas/WhatsappAccountChangesDetailsDto' description: For update account description: The pending changes to account details and information uniqueItems: false required: - status WhatsappInputAccountWhatsAppVerticalsEnum: type: string enum: - ALCOHOL - AUTOMOTIVE - BEAUTY_SPA_SALON - CLOTHING_AND_APPAREL - EDUCATION - ENTERTAINMENT - EVENT_PLANNING_AND_SERVICE - FINANCE_AND_BANKING - FOOD_AND_GROCERY - HOTEL_AND_LODGING - MEDICAL_AND_HEALTH - NON_PROFIT - OTC_DRUGS - OTHER - PHYSICAL_GAMBLING - PROFESSIONAL_SERVICES - PUBLIC_SERVICE - RESTAURANT - SHOPPING_AND_RETAIL - TRAVEL_AND_TRANSPORTATION description: Vertical / business category for the business account. WhatsappInputAccountSenderRelatedDetailsDto: type: object properties: displayName: type: string minLength: 1 maxLength: 255 description: Waba display name / used as default display name of new phone at Meta uniqueItems: false businessCategory: x-enumDescriptions: ALCOHOL: Configures the account profile for a brand operating within the alcohol sector. AUTOMOTIVE: Configures the account profile for a brand operating within the automotive sector. BEAUTY_SPA_SALON: Configures the account profile for a brand operating within beauty, spa, or salon services. CLOTHING_AND_APPAREL: Configures the account profile for a brand operating within clothing and apparel commerce. EDUCATION: Configures the account profile for a brand operating within the education field. ENTERTAINMENT: Configures the account profile for a brand operating within the entertainment and media industry. EVENT_PLANNING_AND_SERVICE: Configures the account profile for a brand operating within event planning and corporate services. FINANCE_AND_BANKING: Configures the account profile for a brand operating within financial and banking services. FOOD_AND_GROCERY: Configures the account profile for a brand operating within the food supply or grocery sector. HOTEL_AND_LODGING: Configures the account profile for a brand operating within hospitality, hotels, or lodging. MEDICAL_AND_HEALTH: Configures the account profile for a brand operating within healthcare or medical services. NON_PROFIT: Configures the account profile for a registered non-profit organization. OTC_DRUGS: Configures the account profile for a brand operating within over-the-counter drug sales and distribution. OTHER: Configures the account profile for an industry operating outside the standard defined taxonomy. PHYSICAL_GAMBLING: Configures the account profile for a brand operating within physical gambling establishments or casinos. PROFESSIONAL_SERVICES: Configures the account profile for a brand providing corporate, professional, or technical services. PUBLIC_SERVICE: Configures the account profile for a brand providing public utilities or governmental services. RESTAURANT: Configures the account profile for a brand operating a restaurant or food service establishment. SHOPPING_AND_RETAIL: Configures the account profile for a brand operating within retail or wholesale commerce. TRAVEL_AND_TRANSPORTATION: Configures the account profile for a brand operating within transportation, travel, or logistics services. description: Vertical / business category for the business account. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappInputAccountWhatsAppVerticalsEnum' region: x-enumDescriptions: BR: Specifies that the sender operations should be initialized within the Brazil region. EU: Specifies that the sender operations should be initialized within the Europe region. US: Specifies that the sender operations should be initialized within the United States region. description: Region sender will be provisioned in. If not provided, default region for the country set in the billing account will be used. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderInputRegionEnum' metaLocalStorage: x-enumDescriptions: AE: Specifies that Meta-managed user and compliance data should be stored within the United Arab Emirates. AU: Specifies that Meta-managed user and compliance data should be stored within Australia. BH: Specifies that Meta-managed user and compliance data should be stored within Bahrain. BR: Specifies that Meta-managed user and compliance data should be stored within Brazil. CA: Specifies that Meta-managed user and compliance data should be stored within Canada. CH: Specifies that Meta-managed user and compliance data should be stored within Switzerland. DE: Specifies that Meta-managed user and compliance data should be stored within Germany. GB: Specifies that Meta-managed user and compliance data should be stored within the United Kingdom. ID: Specifies that Meta-managed user and compliance data should be stored within Indonesia. IN: Specifies that Meta-managed user and compliance data should be stored within India. JP: Specifies that Meta-managed user and compliance data should be stored within Japan. KR: Specifies that Meta-managed user and compliance data should be stored within South Korea. SG: Specifies that Meta-managed user and compliance data should be stored within Singapore. US: Specifies that Meta-managed user and compliance data should be stored within the United States. ZA: Specifies that Meta-managed user and compliance data should be stored within South Africa. description: Region Meta will store data in Meta. If not provided, the default value set for the chosen region will be used. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderInputMetaLocalStoragesEnum' required: - displayName - businessCategory WhatsappAccountDetailsDto: type: object properties: clientBusinessManagerId: type: string description: The Business Manager ID for the client. uniqueItems: false companyLegalName: type: string deprecated: true description: The registered name of the brand who will be engaging with their users. uniqueItems: false wabaName: type: string description: The registered name of the brand who will be engaging with their users. uniqueItems: false senderDetails: description: Details of the sender firstly created. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappAccountSenderRelatedDetailsDto' required: - clientBusinessManagerId - wabaName WhatsappDailyLimitEnum: type: string enum: - NOT_SET - TIER_100K - TIER_10K - TIER_1K - TIER_250 - TIER_2K - TIER_50 - TIER_UNLIMITED - UNRECOGNIZED description: 'This property is deprecated. Use `AccountDto.businessDailyLimit` instead. Current daily message limit of the sender. ' WhatsappPapiErrorDto: type: object properties: errorCode: type: string description: Error code identifying the type of error. uniqueItems: false message: type: string description: Human-readable error message. uniqueItems: false resolution: type: string description: Suggested resolution for the error. uniqueItems: false additionalInformation: type: object additionalProperties: oneOf: - type: array items: type: string description: Additional context about the error. uniqueItems: false required: - errorCode - message - resolution WhatsappAccountDto: type: object properties: state: x-enumDescriptions: ONBOARDED: The onboarding sequence is complete, and the channels linked to the account are active. PENDING_FACEBOOK_VERIFICATION: The account setup awaits completed Facebook business verification workflows. REJECTED: The account profile registration or verification sequence was reviewed and rejected. description: The current state of your account. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappAccountStateEnum' isEmbeddedSignup: type: boolean description: '`true` if the Account was created through Embedded Signup. `false` otherwise.' uniqueItems: false businessManager: x-enumDescriptions: SINCH_AMERICA: Associates the profile configuration with the Sinch America Meta Business Manager account. SINCH_BR: Associates the profile configuration with the Sinch Brazil Meta Business Manager account. SINCH_MX: Associates the profile configuration with the Sinch Mexico Meta Business Manager account. SINCH_SEP: Associates the profile configuration with the Sinch SEP Meta Business Manager account. SINCH_UK: Associates the profile configuration with the Sinch UK Meta Business Manager account. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Business manager. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappBusinessManagersEnum' wabaId: type: string description: WhatsApp Business Manager ID. uniqueItems: false changes: description: Any pending changes to the account. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappAccountChangesDto' details: description: Account details and information. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappAccountDetailsDto' wabaBanState: x-enumDescriptions: DISABLE: The WhatsApp Business Account has been disabled due to administrative or policy enforcement. REINSTATE: The WhatsApp Business Account has been successfully reinstated and cleared of restrictions. SCHEDULE_FOR_DISABLE: The WhatsApp Business Account is scheduled for automatic disablement following a grace or appeal period. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Ban state when account has been banned. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappWabaBanStatesEnum' wabaBanDate: type: string description: The UTC Date Time in ISO 8601 for when account has been banned. uniqueItems: false wabaEnabledForInsights: type: boolean description: Template analytics status for account. uniqueItems: false wabaEnabledForDirectSend: type: boolean description: Direct Send API status for account. uniqueItems: false wabaMaxPriceOnboarded: type: boolean description: Indicates whether the account has the maximum price feature enabled. uniqueItems: false compatibleRegions: type: array x-enumDescriptions: br: The messaging applications and session contexts are hosted within the Brazil region. eu: The messaging applications and session contexts are hosted within the Europe region. us: The messaging applications and session contexts are hosted within the United States region. uniqueItems: true description: Conversation API app regions the sender can be used for. items: $ref: '#/components/schemas/WhatsappConversationAppRegionsEnum' primaryBusinessLocation: x-enumDescriptions: AD: The country code for Andorra. AE: The country code for the United Arab Emirates. AF: The country code for Afghanistan. AG: The country code for Antigua and Barbuda. AI: The country code for Anguilla. AL: The country code for Albania. AM: The country code for Armenia. AO: The country code for Angola. AQ: The country code for Antarctica. AR: The country code for Argentina. AS: The country code for American Samoa. AT: The country code for Austria. AU: The country code for Australia. AW: The country code for Aruba. AZ: The country code for Azerbaijan. BA: The country code for Bosnia and Herzegovina. BB: The country code for Barbados. BD: The country code for Bangladesh. BE: The country code for Belgium. BF: The country code for Burkina Faso. BG: The country code for Bulgaria. BH: The country code for Bahrain. BI: The country code for Burundi. BJ: The country code for Benin. BM: The country code for Bermuda. BN: The country code for Brunei. BO: The country code for Bolivia. BQ: The country code for Bonaire. BR: The country code for Brazil. BS: The country code for the Bahamas. BT: The country code for Bhutan. BW: The country code for Botswana. BY: The country code for Belarus. BZ: The country code for Belize. CA: The country code for Canada. CD: The country code for the Democratic Republic of the Congo. CF: The country code for the Central African Republic. CG: The country code for the Republic of the Congo. CH: The country code for Switzerland. CI: The country code for the Ivory Coast. CK: The country code for the Cook Islands. CL: The country code for Chile. CM: The country code for Cameroon. CN: The country code for China. CO: The country code for Colombia. CR: The country code for Costa Rica. CU: The country code for Cuba. CV: The country code for Cape Verde. CW: The country code for Curaçao. CY: The country code for Cyprus. CZ: The country code for the Czech Republic. DE: The country code for Germany. DJ: The country code for Djibouti. DK: The country code for Denmark. DM: The country code for Dominica. DO: The country code for the Dominican Republic. DZ: The country code for Algeria. EC: The country code for Ecuador. EE: The country code for Estonia. EG: The country code for Egypt. ER: The country code for Eritrea. ES: The country code for Spain. ET: The country code for Ethiopia. FI: The country code for Finland. FJ: The country code for Fiji. FK: The country code for the Falkland Islands. FM: The country code for Micronesia. FO: The country code for the Faroe Islands. FR: The country code for France. GA: The country code for Gabon. GB: The country code for the United Kingdom of Great Britain. GD: The country code for Grenada. GE: The country code for Georgia. GF: The country code for French Guiana. GG: The country code for Guernsey. GH: The country code for Ghana. GI: The country code for Gibraltar. GL: The country code for Greenland. GM: The country code for the Gambia. GN: The country code for Guinea. GP: The country code for Guadeloupe. GQ: The country code for Equatorial Guinea. GR: The country code for Greece. GT: The country code for Guatemala. GU: The country code for Guam. GW: The country code for Guinea-Bissau. GY: The country code for Guyana. HK: The country code for Hong Kong. HN: The country code for Honduras. HR: The country code for Croatia. HT: The country code for Haiti. HU: The country code for Hungary. ID: The country code for Indonesia. IE: The country code for Ireland. IL: The country code for Israel. IM: The country code for the Isle of Man. IN: The country code for India. IO: The country code for the British Indian Ocean Territory. IQ: The country code for Iraq. IR: The country code for Iran. IS: The country code for Iceland. IT: The country code for Italy. JE: The country code for Jersey. JM: The country code for Jamaica. JO: The country code for Jordan. JP: The country code for Japan. KE: The country code for Kenya. KG: The country code for Kyrgyzstan. KH: The country code for Cambodia. KI: The country code for Kiribati. KM: The country code for Comoros. KN: The country code for Saint Kitts and Nevis. KP: The country code for North Korea. KR: The country code for South Korea. KW: The country code for Kuwait. KY: The country code for the Cayman Islands. KZ: The country code for Kazakhstan. LA: The country code for Laos. LB: The country code for Lebanon. LC: The country code for Saint Lucia. LI: The country code for Liechtenstein. LK: The country code for Sri Lanka. LR: The country code for Liberia. LS: The country code for Lesotho. LT: The country code for Lithuania. LU: The country code for Luxembourg. LV: The country code for Latvia. LY: The country code for Libya. MA: The country code for Morocco. MC: The country code for Monaco. MD: The country code for Moldova. ME: The country code for Montenegro. MG: The country code for Madagascar. MH: The country code for the Marshall Islands. MK: The country code for North Macedonia. ML: The country code for Mali. MM: The country code for Myanmar. MN: The country code for Mongolia. MO: The country code for Macao. MP: The country code for the Northern Mariana Islands. MQ: The country code for Martinique. MR: The country code for Mauritania. MS: The country code for Montserrat. MT: The country code for Malta. MU: The country code for Mauritius. MV: The country code for the Maldives. MW: The country code for Malawi. MX: The country code for Mexico. MY: The country code for Malaysia. MZ: The country code for Mozambique. NA: The country code for Namibia. NC: The country code for New Caledonia. NE: The country code for Niger. NF: The country code for Norfolk Island. NG: The country code for Nigeria. NI: The country code for Nicaragua. NL: The country code for the Netherlands. 'NO': The country code for Norway. NP: The country code for Nepal. NR: The country code for Nauru. NU: The country code for Niue. NZ: The country code for New Zealand. OM: The country code for Oman. PA: The country code for Panama. PE: The country code for Peru. PF: The country code for French Polynesia. PG: The country code for Papua New Guinea. PH: The country code for the Philippines. PK: The country code for Pakistan. PL: The country code for Poland. PM: The country code for Saint Pierre and Miquelon. PR: The country code for Puerto Rico. PS: The country code for Palestine. PT: The country code for Portugal. PW: The country code for Palau. PY: The country code for Paraguay. QA: The country code for Qatar. RE: The country code for Réunion. RO: The country code for Romania. RS: The country code for Serbia. RU: The country code for Russia. RW: The country code for Rwanda. SA: The country code for Saudi Arabia. SB: The country code for the Solomon Islands. SC: The country code for Seychelles. SD: The country code for Sudan. SE: The country code for Sweden. SG: The country code for Singapore. SH: The country code for Saint Helena. SI: The country code for Slovenia. SK: The country code for Slovakia. SL: The country code for Sierra Leone. SM: The country code for San Marino. SN: The country code for Senegal. SO: The country code for Somalia. SR: The country code for Suriname. SS: The country code for South Sudan. ST: The country code for São Tomé and Príncipe. SV: The country code for El Salvador. SX: The country code for Sint Maarten. SY: The country code for Syria. SZ: The country code for Eswatini. TC: The country code for the Turks and Caicos Islands. TD: The country code for Chad. TG: The country code for Togo. TH: The country code for Thailand. TJ: The country code for Tajikistan. TK: The country code for Tokelau. TL: The country code for East Timor. TM: The country code for Turkmenistan. TN: The country code for Tunisia. TO: The country code for Tonga. TR: The country code for Turkey. TT: The country code for Trinidad and Tobago. TV: The country code for Tuvalu. TW: The country code for Taiwan. TZ: The country code for Tanzania. UA: The country code for Ukraine. UG: The country code for Uganda. UM: The country code for the United States Minor Outlying Islands. US: The country code for the United States of America. UY: The country code for Uruguay. UZ: The country code for Uzbekistan. VC: The country code for Saint Vincent and the Grenadines. VE: The country code for Venezuela. VG: The country code for the British Virgin Islands. VI: The country code for the United States Virgin Islands. VN: The country code for Vietnam. VU: The country code for Vanuatu. WF: The country code for Wallis and Futuna. WS: The country code for Samoa. XK: The country code for Kosovo. YE: The country code for Yemen. YT: The country code for Mayotte. ZA: The country code for South Africa. ZM: The country code for Zambia. ZW: The country code for Zimbabwe. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Two-letter country code in ISO 3166 standard, specifying the country where business is based uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappCountryCodesEnum' partnerInitiatedRequestId: type: string deprecated: true description: Deprecated. This field is retained for backward compatibility and is always returned as undefined. uniqueItems: false businessDailyLimit: x-enumDescriptions: NOT_SET: The daily messaging threshold tier has not been assigned. TIER_100K: Restricts outbound traffic up to 100,000 business-initiated conversations per rolling 24-hour cycle. TIER_10K: Restricts outbound traffic up to 10,000 business-initiated conversations per rolling 24-hour cycle. TIER_1K: Restricts outbound traffic up to 1,000 business-initiated conversations per rolling 24-hour cycle. TIER_250: Restricts outbound traffic up to 250 business-initiated conversations per rolling 24-hour cycle. TIER_2K: Restricts outbound traffic up to 2,000 business-initiated conversations per rolling 24-hour cycle. TIER_50: Restricts outbound traffic up to 50 business-initiated conversations per rolling 24-hour cycle. TIER_UNLIMITED: No daily throttling thresholds or messaging limit restrictions apply to this profile. UNRECOGNIZED: The value returned by an upstream system is not recognized by this API version. description: Current daily message limit of the account. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappDailyLimitEnum' currency: type: string description: The currency code for the account. uniqueItems: false required: - isEmbeddedSignup - businessManager - wabaMaxPriceOnboarded - compatibleRegions WhatsappInputBusinessManagersEnum: type: string enum: - SINCH_AMERICA - SINCH_BR - SINCH_MX - SINCH_SEP - SINCH_UK description: Business manager. WhatsappAccountNotificationListDto: type: object properties: totalSize: type: number description: Total size of the entries matching the search query. uniqueItems: false pageSize: type: number description: Requested size of the page. uniqueItems: false previousPageToken: type: string description: Encoded token to use in list request to fetch previous batch of entries. uniqueItems: false nextPageToken: type: string description: Encoded token to use in list request to fetch next batch of entries. uniqueItems: false notifications: type: array items: $ref: '#/components/schemas/WhatsappAccountNotificationDto' uniqueItems: false required: - totalSize - pageSize - notifications WhatsappAccountStateEnum: type: string enum: - ONBOARDED - PENDING_FACEBOOK_VERIFICATION - REJECTED description: The current state of your account. WhatsappCommentDto: type: object properties: type: x-enumDescriptions: CREATED: Indicates the comment has been successfully created and published. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappCommentTypeEnum' comment: type: string uniqueItems: false created: type: string uniqueItems: false required: - type - comment WhatsappInputAccountSenderRelatedUpdateDetailsDto: type: object properties: displayName: type: string minLength: 1 maxLength: 255 description: Waba display name / used as default display name of new phone at Meta uniqueItems: false businessCategory: x-enumDescriptions: ALCOHOL: Configures the account profile for a brand operating within the alcohol sector. AUTOMOTIVE: Configures the account profile for a brand operating within the automotive sector. BEAUTY_SPA_SALON: Configures the account profile for a brand operating within beauty, spa, or salon services. CLOTHING_AND_APPAREL: Configures the account profile for a brand operating within clothing and apparel commerce. EDUCATION: Configures the account profile for a brand operating within the education field. ENTERTAINMENT: Configures the account profile for a brand operating within the entertainment and media industry. EVENT_PLANNING_AND_SERVICE: Configures the account profile for a brand operating within event planning and corporate services. FINANCE_AND_BANKING: Configures the account profile for a brand operating within financial and banking services. FOOD_AND_GROCERY: Configures the account profile for a brand operating within the food supply or grocery sector. HOTEL_AND_LODGING: Configures the account profile for a brand operating within hospitality, hotels, or lodging. MEDICAL_AND_HEALTH: Configures the account profile for a brand operating within healthcare or medical services. NON_PROFIT: Configures the account profile for a registered non-profit organization. OTC_DRUGS: Configures the account profile for a brand operating within over-the-counter drug sales and distribution. OTHER: Configures the account profile for an industry operating outside the standard defined taxonomy. PHYSICAL_GAMBLING: Configures the account profile for a brand operating within physical gambling establishments or casinos. PROFESSIONAL_SERVICES: Configures the account profile for a brand providing corporate, professional, or technical services. PUBLIC_SERVICE: Configures the account profile for a brand providing public utilities or governmental services. RESTAURANT: Configures the account profile for a brand operating a restaurant or food service establishment. SHOPPING_AND_RETAIL: Configures the account profile for a brand operating within retail or wholesale commerce. TRAVEL_AND_TRANSPORTATION: Configures the account profile for a brand operating within transportation, travel, or logistics services. description: Vertical / business category for the business account. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappInputAccountWhatsAppVerticalsEnum' region: x-enumDescriptions: BR: Specifies that the sender operations should be initialized within the Brazil region. EU: Specifies that the sender operations should be initialized within the Europe region. US: Specifies that the sender operations should be initialized within the United States region. description: Region sender will be provisioned in. If not provided, default region for the country set in the billing account will be used. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderInputRegionEnum' metaLocalStorage: x-enumDescriptions: AE: Specifies that Meta-managed user and compliance data should be stored within the United Arab Emirates. AU: Specifies that Meta-managed user and compliance data should be stored within Australia. BH: Specifies that Meta-managed user and compliance data should be stored within Bahrain. BR: Specifies that Meta-managed user and compliance data should be stored within Brazil. CA: Specifies that Meta-managed user and compliance data should be stored within Canada. CH: Specifies that Meta-managed user and compliance data should be stored within Switzerland. DE: Specifies that Meta-managed user and compliance data should be stored within Germany. GB: Specifies that Meta-managed user and compliance data should be stored within the United Kingdom. ID: Specifies that Meta-managed user and compliance data should be stored within Indonesia. IN: Specifies that Meta-managed user and compliance data should be stored within India. JP: Specifies that Meta-managed user and compliance data should be stored within Japan. KR: Specifies that Meta-managed user and compliance data should be stored within South Korea. SG: Specifies that Meta-managed user and compliance data should be stored within Singapore. US: Specifies that Meta-managed user and compliance data should be stored within the United States. ZA: Specifies that Meta-managed user and compliance data should be stored within South Africa. description: Region Meta will store data in Meta. If not provided, the default value set for the chosen region will be used. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappSenderInputMetaLocalStoragesEnum' WhatsappAccountNotificationTypeEnum: type: string enum: - COMMENT_ADDED - CREATED - DRAFT - EDITED - IN_PROGRESS - PENDING_FACEBOOK_VERIFICATION - REJECTED WhatsappAccountNotificationDto: type: object properties: type: x-enumDescriptions: COMMENT_ADDED: A new comment has been added to the notification trail. CREATED: The notification configuration has been successfully created. DRAFT: The notification configuration is currently in a draft state. EDITED: The notification configuration has been edited or updated. IN_PROGRESS: The notification process is currently executing. PENDING_FACEBOOK_VERIFICATION: The notification setup is pending Facebook account verification. REJECTED: The notification configuration has been rejected. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappAccountNotificationTypeEnum' created: type: string uniqueItems: false author: type: string uniqueItems: false comment: type: string uniqueItems: false required: - type WhatsappSenderInputRegionEnum: type: string enum: - BR - EU - US description: Region sender is provisioned in. If not provided, default region for the country set in the billing account will be used. For partner-initiated accounts, the value set for WhatsApp account will be used. WhatsappCountryCodesEnum: type: string enum: - 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 description: Upscalable country codes (ISO 3166-1 alpha-2). WhatsappBusinessManagersEnum: type: string enum: - SINCH_AMERICA - SINCH_BR - SINCH_MX - SINCH_SEP - SINCH_UK - UNRECOGNIZED description: Business manager. WhatsappAccountChangesDetailsDto: type: object properties: clientBusinessManagerId: type: string description: The Business Manager ID for the client. uniqueItems: false companyLegalName: type: string deprecated: true description: The registered name of the brand who will be engaging with their users. uniqueItems: false wabaName: type: string description: The registered name of the brand who will be engaging with their users. uniqueItems: false senderDetails: description: Details of the sender firstly created. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappAccountSenderRelatedChangesDetailsDto' WhatsappInputUpdateAccountDto: type: object properties: companyLegalName: type: string deprecated: true minLength: 1 maxLength: 255 description: 'The registered name of the brand who will be engaging with their users needs to be specified. This name must match the name associated with the Facebook Business Manager ID below. You can verify the registered name by visiting: https://business.facebook.com/select/?business_id= Ensure that the name shown exactly matches the one you enter here.' uniqueItems: false wabaName: type: string minLength: 1 maxLength: 255 description: 'The registered name of the brand who will be engaging with their users needs to be specified. This name must match the name associated with the Facebook Business Manager ID below. You can verify the registered name by visiting: https://business.facebook.com/select/?business_id= Ensure that the name shown exactly matches the one you enter here.' uniqueItems: false clientBusinessManagerId: type: string minLength: 1 maxLength: 255 description: The Business Manager ID for the client to create the account. This can be found in the Meta Business Manager in Business Settings > Business Info below the Business Manager Account Name. uniqueItems: false senderDetails: description: Details of the sender to be created. uniqueItems: false allOf: - $ref: '#/components/schemas/WhatsappInputAccountSenderRelatedUpdateDetailsDto' WhatsappWabaBanStatesEnum: type: string enum: - DISABLE - REINSTATE - SCHEDULE_FOR_DISABLE - UNRECOGNIZED description: Please use get account endpoint for this information. securitySchemes: BasicAuth: type: http scheme: basic BearerAuth: type: http scheme: bearer bearerFormat: JWT OAuth2Production: type: oauth2 description: OAuth2 authorization for production flows: clientCredentials: tokenUrl: https://auth.sinch.com/oauth2/token scopes: '-': '-' x-tagGroup-upscale: name: Upscale tags: - Upscale Admin Feature Flag - Upscale Admin Log Operation - Upscale Admin Migrations - Upscale Admin Sms - Upscale Admin Upscales - Internal - Upscale Sms - Upscale Upscales x-tagGroup-notification: name: Notification tags: - Notification Admin Feature Flag - Notification Admin Log Operation - Internal x-tagGroups: - name: Webhook tags: - Webhooks - name: WhatsApp tags: - WhatsApp Accounts - WhatsApp - WhatsApp Flows - WhatsApp Senders - WhatsApp Solutions - WhatsApp Templates - name: Bundles tags: - Bundles - name: KakaoTalk tags: - KakaoTalk Categories - KakaoTalk Senders - KakaoTalk Templates - name: Conversation tags: - Conversation - name: RCS tags: - RCS Accounts - RCS Questionnaire - RCS Senders - name: SMS tags: - SMS Apps