Turn on WhatsApp calling

Server URLloading...

PUT

/numbers/{id}/whatsapp

Send

Authorization

Path

Body

Give VoiceDock the SIP password Meta generated for this number, so that WhatsApp calls to the number reach your assistant. Do this after you have turned on calling over SIP for the number at Meta; the WhatsApp calling guide has every step.

The change is applied in the background: the response is 202 with status pending, and GET shows active once it is done, usually within a minute. On a number where WhatsApp calling is already set up, this replaces the stored password, for example after you reset it at Meta.

The number must be active and must not already receive its calls through another SIP provider, such as your own SIP trunk. An organization can use WhatsApp calling on up to 10 numbers; contact support for more. This endpoint and DELETE are limited to 10 requests per minute per API key.

Path Parameters

Response Body

curl -X PUT "https://example.com/numbers/497f6eca-6276-4993-bfeb-53cbbbba6f08/whatsapp" \  -H "Content-Type: application/json" \  -d '{    "sip_password": "your-sip-password-from-meta"  }'

{
  "status": "pending",
  "error_code": null,
  "sip_username": "31850835037",
  "updated_at": "2026-10-15T12:00:00Z"
}

{
  "error": "Invalid API key",
  "message": "string"
}

{
  "error": "whatsapp_number_limit_reached",
  "message": "Your organization has reached its limit of numbers with WhatsApp calling. Turn it off on another number or contact support."
}

{
  "error": "number_not_found",
  "message": "No number with this ID in your organization."
}

{
  "error": "number_inactive",
  "message": "The number is inactive. Turn it on first."
}

{
  "error": "invalid_sip_password",
  "message": "sip_password must be 8 to 200 characters."
}

{
  "error": "Invalid API key",
  "message": "string"
}