Add WhatsApp sender Early access

Add a WhatsApp sender to your WhatsApp Business Account and initiate the verification process. If the sender is recognized as already verified, it will be automatically submitted for registration.

Please log in to see full path URL. Learn why.
post
/whatsapp/1/embedded-signup/registrations/business-account/{businessAccountId}/senders
Request rate limit:
15 requests / second (per account)
path Parameters
businessAccountId
required
integer <int64>
Example: 12345567897878

WhatsApp Business Account Id.

Request Body schema:
application/json
collapse all -
countryCode
required
string

Country code of the phone number.

phoneNumber
required
string

Phone number to add.

displayName
required
string

Display name of the phone number.

type
required
string
Enum: "EXTERNAL_SMS" "EXTERNAL_VOICE"

Type of the phone number. It specifies verification type.

locale
required
string
Default: "en_US"

Locale which will be used to submit for verification.

Responses

202

Sender accepted for verification, if it is already verified it will be submitted for registration.

400

Bad request.

401

Unauthorized

403

Forbidden

404

Sender not found.

429

Too Many Requests

500

Internal Server Error

Request samples

Content type
application/json
Copy
Collapse all
{
  • "countryCode": "44",
  • "phoneNumber": "7796344125",
  • "displayName": "Infobip",
  • "type": "EXTERNAL_SMS",
  • "locale": "en_US"
}

Response samples

Content type
application/json
Copy
Collapse all
{
  • "status": "SUBMITTED_FOR_REGISTRATION"
}

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Learn more
Service status

Copyright @ 2006-2025 Infobip ltd.