Skip to main content
POST
Create cloud_api connection manually
Creates a WhatsApp Official API connection from credentials generated in Meta Business Manager: the WhatsApp Business Account id (wabaId), the phone number id (phoneNumberId) and an accessToken. The backend validates the (number, token) pair against the Graph API, tries to subscribe the app’s webhooks (best-effort) and then provisions the connection and syncs billing for the Scale plan.
  • webhookMode — normalized (canonical D-API events) or meta_passthrough (raw Meta payloads). Default: normalized.
  • data.webhookSubscribed — when false, show the user the instructions for subscribing the webhook manually in the Meta dashboard.
Requires an active subscription. Without a subscription, the response is 402 with code: "TRIAL_REQUIRED" — send the user to the Scale plan checkout.
For the guided Embedded Signup (SDK) flow, use the integration assistant instead of registering the token manually.

Authorizations

Authorization
string
header
required

API Key for authentication. Format: <API_KEY>

Body

wabaId
string
required
Minimum string length: 1
phoneNumberId
string
required
Minimum string length: 1
accessToken
string
required
Minimum string length: 1
businessId
string
webhookMode
Allowed value: "normalized"

Response

Successful response

success
boolean
required
data
any
error
string
code
string