---
title: "Create account for project"
method: POST
path: "/v1/projects/{projectId}/whatsapp"
tags: ["WhatsApp Accounts"]
---

# Create account for project

`POST /v1/projects/{projectId}/whatsapp`

Create the WhatsApp account for the project. Each project can only have one account.

## Path parameters

- `projectId` string, required

## Request body

- union
  - WhatsappInputAccountPartnerInitiatedDto
    - `wabaName` string, required — 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=<your_business_manager_id> Ensure that the name shown exactly matches the one you enter here.
    - `clientBusinessManagerId` string, required — 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.
    - `businessManager` 'SINCH_AMERICA' | 'SINCH_BR' | 'SINCH_MX' | 'SINCH_SEP' | 'SINCH_UK' — Business manager.
    - `senderDetails` WhatsappInputAccountSenderRelatedDetailsDto, required
      - `displayName` string, required — Waba display name / used as default display name of new phone at Meta
      - `businessCategory` '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' | 'OTC_DRUGS' | 'OTHER' | 'PHYSICAL_GAMBLING' | 'PROFESSIONAL_SERVICES' | 'PUBLIC_SERVICE' | 'RESTAURANT' | 'SHOPPING_AND_RETAIL' | 'TRAVEL_AND_TRANSPORTATION', required — Vertical / business category for the business account.
      - `region` 'BR' | 'EU' | 'US' — Region sender will be provisioned in. If not provided, default region for the country set in the billing account will be used.
      - `metaLocalStorage` 'AE' | 'AU' | 'BH' | 'BR' | 'CA' | 'CH' | 'DE' | 'GB' | 'ID' | 'IN' | 'JP' | 'KR' | 'SG' | 'US' | 'ZA' — Region Meta will store data in Meta. If not provided, the default value set for the chosen region will be used.
  - WhatsappInputAccountDtoDeprecated — InputAccountDto is deprecated as Meta officially has declared End-Of-Life (EOL) of OBO on September 30, 2025.
    - `clientBusinessManagerId` string, required — 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.
    - `businessManager` 'SINCH_AMERICA' | 'SINCH_BR' | 'SINCH_MX' | 'SINCH_SEP' | 'SINCH_UK' — Business manager.
    - `companyLegalName` string, required — 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=<your_business_manager_id> Ensure that the name shown exactly matches the one you enter here.

## Response `201`

Account

- WhatsappAccountDto
  - `state` 'ONBOARDED' | 'PENDING_FACEBOOK_VERIFICATION' | 'REJECTED' — The current state of your account.
  - `isEmbeddedSignup` boolean, required — `true` if the Account was created through Embedded Signup. `false` otherwise.
  - `businessManager` 'SINCH_AMERICA' | 'SINCH_BR' | 'SINCH_MX' | 'SINCH_SEP' | 'SINCH_UK' | 'UNRECOGNIZED', required — Business manager.
  - `wabaId` string — WhatsApp Business Manager ID.
  - `changes` WhatsappAccountChangesDto
    - `status` 'DRAFT' | 'IN_PROGRESS' | 'PENDING_FACEBOOK_VERIFICATION' | 'REJECTED', required — Current status of the pending changes.
    - `details` union — The pending changes to account details and information
      - object
        - `clientBusinessManagerId` string, required — The Business Manager ID for the client.
        - `companyLegalName` string — The registered name of the brand who will be engaging with their users.
        - `wabaName` string, required — The registered name of the brand who will be engaging with their users.
        - `senderDetails` WhatsappAccountSenderRelatedDetailsDto
          - `displayName` string, required — Waba display name / used as default display name of new phone at Meta
          - `businessCategory` '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', required — Vertical / business category for the business account.
          - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required — Region for the partner-initiated sender.
          - `metaLocalStorage` 'AE' | 'AU' | 'BH' | 'BR' | 'CA' | 'CH' | 'DE' | 'GB' | 'ID' | 'IN' | 'JP' | 'KR' | 'SG' | 'US' | 'ZA' | 'UNRECOGNIZED' | 'UNSPECIFIED', required — Local storage region for the partner-initiated sender.
      - object
        - `clientBusinessManagerId` string — The Business Manager ID for the client.
        - `companyLegalName` string — The registered name of the brand who will be engaging with their users.
        - `wabaName` string — The registered name of the brand who will be engaging with their users.
        - `senderDetails` WhatsappAccountSenderRelatedChangesDetailsDto
          - `displayName` string, required — Waba display name / used as default display name of new phone at Meta
          - `businessCategory` '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', required — Vertical / business category for the business account.
          - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required — Region for the partner-initiated sender.
          - `metaLocalStorage` 'AE' | 'AU' | 'BH' | 'BR' | 'CA' | 'CH' | 'DE' | 'GB' | 'ID' | 'IN' | 'JP' | 'KR' | 'SG' | 'US' | 'ZA' | 'UNRECOGNIZED' | 'UNSPECIFIED', required — Local storage region for the partner-initiated sender.
  - `details` WhatsappAccountDetailsDto
    - `clientBusinessManagerId` string, required — The Business Manager ID for the client.
    - `companyLegalName` string — The registered name of the brand who will be engaging with their users.
    - `wabaName` string, required — The registered name of the brand who will be engaging with their users.
    - `senderDetails` WhatsappAccountSenderRelatedDetailsDto
      - `displayName` string, required — Waba display name / used as default display name of new phone at Meta
      - `businessCategory` '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', required — Vertical / business category for the business account.
      - `region` 'BR' | 'EU' | 'US' | 'UNRECOGNIZED', required — Region for the partner-initiated sender.
      - `metaLocalStorage` 'AE' | 'AU' | 'BH' | 'BR' | 'CA' | 'CH' | 'DE' | 'GB' | 'ID' | 'IN' | 'JP' | 'KR' | 'SG' | 'US' | 'ZA' | 'UNRECOGNIZED' | 'UNSPECIFIED', required — Local storage region for the partner-initiated sender.
  - `wabaBanState` 'DISABLE' | 'REINSTATE' | 'SCHEDULE_FOR_DISABLE' | 'UNRECOGNIZED' — Ban state when account has been banned.
  - `wabaBanDate` string — The UTC Date Time in ISO 8601 for when account has been banned.
  - `wabaEnabledForInsights` boolean — Template analytics status for account.
  - `wabaEnabledForDirectSend` boolean — Direct Send API status for account.
  - `compatibleRegions` string[], required — Conversation API app regions the sender can be used for.
  - `primaryBusinessLocation` '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' — Two-letter country code in ISO 3166 standard, specifying the country where business is based
  - `partnerInitiatedRequestId` string — Deprecated. This field is retained for backward compatibility and is always returned as undefined.
  - `businessDailyLimit` 'NOT_SET' | 'TIER_100K' | 'TIER_10K' | 'TIER_1K' | 'TIER_250' | 'TIER_2K' | 'TIER_50' | 'TIER_UNLIMITED' | 'UNRECOGNIZED' — Current daily message limit of the account.
  - `currency` string — The currency code for the account.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound
- `409` — Conflict
- `500` — InternalServerError

---

[API](https://skmtc.net/sinch/apis/provisioning-api.md) · [All operations](https://skmtc.net/sinch/apis/provisioning-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/provisioning-api/revisions/c78a716de420/schema)