Skip to main content
POST
Register a WhatsApp Cloud number

Authorizations

Authorization
string
header
required

Personal access token (izap_pat_…) sent as Authorization: Bearer ; dashboard session JWTs are also accepted.

Headers

business-id
string | null
required

UUID of the business the request is scoped to. Required on this route; the deprecated /businesses/{business_id}/... form takes it from the path instead.

Body

application/json
code
string
required
phone_number_id
string | null
redirect_uri
string | null
waba_business_id
string | null
waba_id
string | null

Response

Successful Response

202 body of POST /{business_id}/whatsapp_cloud/register.

task_id
string<uuid>
required
status
enum<string>
default:pending

Lifecycle of an async registration job.

PENDING is created by POST /auth/register before the worker picks it up. PROCESSING means the dramatiq actor is running. Terminal states are COMPLETED (account ready) and FAILED (see error_code / error_detail).

Available options:
pending,
processing,
completed,
failed