API ReferenceConnections
Create Connection
Create a new WhatsApp connection and provision a WAHA session.
POST /api/connections
Creates a new WhatsApp connection for the authenticated user. This provisions a WAHA session on an available worker pod. No request body is needed.
After creation, the connection will be in scan_qr status. Use the Get QR Code endpoint to retrieve the QR code for linking your WhatsApp account.
Authentication
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token. Format: Bearer <token> |
Response
{
"id": "c1a2b3c4-d5e6-7f89-0abc-def123456789",
"userId": "your-user-id",
"workerId": "w9a8b7c6-d5e4-3f21-0fed-cba987654321",
"sessionName": "u_a80ffc98_s_c1a2b3c4",
"phoneNumber": null,
"status": "scan_qr",
"engine": "NOWEB",
"createdAt": "2026-03-14T10:00:00.000Z",
"updatedAt": "2026-03-14T10:00:00.000Z"
}{
"statusCode": 401,
"message": "Unauthorized"
}{
"statusCode": 503,
"message": "No available workers. Please try again shortly."
}