# POST /whatsapp/pair

**Resource:** [WhatsApp](./whatsapp.md)  
**MCP tool:** `start_whatsapp_pair`  
**Scopes:** `whatsapp:write`  
**Write operation:** yes

Begin pairing a WhatsApp account to the workspace. Returns a QR code data URL the user scans with their phone (Settings → Linked Devices → Link a Device). The pairing becomes "connected" automatically once they scan.

## Request example

```bash
curl -X POST   "https://api.trustpager.com/functions/v1/api/v1/whatsapp/pair"   -H "Authorization: Bearer YOUR_API_KEY"
```

## Response example

```json
{
  "data": {
    "success": true,
    "pairing_id": "uuid...",
    "qr_code_data_url": "data:image/png;base64,...",
    "pairing_code": "ABCD-EFGH",
    "status": "awaiting_qr",
    "qr_expires_at": "2026-05-28T10:01:00Z"
  }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`