whatsapp:create
whatsapp family
Create a workspace's own WhatsApp line: connect one WhatsApp Business number to a workspace, from a key. Proves the token owns that phone number id (a Graph read of the WhatsApp Business Account's numbers), seals the token and the number together on the workspace's whatsapp-cloud connection, which is what the channels webhook routes that number's messages by and what replies go out from. One number per workspace: connecting a new one retires the old. Refuses a number another workspace holds. Re-running it on the same number with a new token re-seals the token (rotated); a number the workspace retired can be connected again. Safe to re-run; dryRun checks the token and the number and names the number it would replace, writing nothing. The token is never echoed. Needs a Meta app and a WhatsApp Business Account the number lives in.
- Effect
- ask
- Awaits an outcome — the call returns the response below.
- Caller
- manage_integrations
- The class of authority the caller must already hold, decided from the attested context with no round trip.
- Cost
- free
- What one call costs, so you can budget before acting.
- Reversible
- no
- This cannot be undone. Dry-run it first where the contract allows.
- Idempotent
- yes
- Safe to retry as-is.
- Version
- 1.0.0
- Pin this to keep a contract stable; additive bumps never break callers.