Disconnect Meta WhatsApp
Disconnect the WhatsApp Business Account from your workspace.
DELETE
This affects every WhatsApp message flow in the workspace. Each message flow on the Meta-Whatsapp channel loses its WhatsApp phone number, access token, default template and customer-number assignments, and its WhatsApp outbound messaging (settings.whatsappOutbound.enabled) is turned off. Reconnecting WhatsApp does not restore these. Each flow has to be set up again.
Your role needs the workspace:edit permission. Otherwise the request fails with 403 {"error": "Insufficient permissions", "requiredPermission": "workspace:edit"}.
Headers
x-workspace-idstringrequiredThe workspace to disconnect WhatsApp from.
Response Fields
metaWhatsAppnullAlways null, meaning the workspace no longer has a WhatsApp connection.
Errors
| Status | Body | When |
|---|---|---|
403 | {"error": "Insufficient permissions"} | Your role lacks workspace:edit |
404 | {"message": "Workspace not found"} | The workspace doesn't exist |
500 | {"message": "Error disconnecting Meta WhatsApp from workspace"} | Unexpected server error |
{
"metaWhatsApp": null
}Last updated on