---
title: "Authorize Meta WhatsApp"
api: "GET /v1/api/meta-whatsapp/authorize"
description: "Get the Meta OAuth authorization URL to connect a WhatsApp Business Account to your workspace."
lastUpdated: "2026-11-04"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

Open the returned URL in a browser popup and approve access. Meta then redirects back to Trillet. The connection is made at the **workspace** level, not per flow.

Choosing which WhatsApp Business Account and phone number to use, and attaching it to a message flow, is done in the portal. Those steps are not part of the public API yet.

<Note>
Your role needs the `workspace:edit` permission. Otherwise the request fails with `403 {"error": "Insufficient permissions", "requiredPermission": "workspace:edit"}`.
</Note>

## Headers
<ParamField header="x-workspace-id" type="string" required>
The workspace to connect WhatsApp to.
</ParamField>

## Response Fields

<ResponseField name="authorizeUrl" type="string">
The Meta OAuth authorization URL (Graph API v21.0, popup display). Open it in a browser to authorize the WhatsApp Business connection.
</ResponseField>

## Errors

| Status | Body | When |
| --- | --- | --- |
| `403` | `{"error": "Insufficient permissions"}` | Your role lacks `workspace:edit` |
| `500` | `{"message": "Error generating Meta WhatsApp authorize URL"}` | Unexpected server error |

<ResponseExample>
```json
{
  "authorizeUrl": "https://www.facebook.com/v21.0/dialog/oauth?client_id=...&redirect_uri=...&response_type=code&state=...&display=popup&config_id=..."
}
```
</ResponseExample>


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
