Skip to main content
POST
/
v1
/
instances
/
{instance_id}
/
channels
/
{channel}
/
pair
curl -X POST https://api.chowder.dev/v1/instances/ins_abc123/channels/whatsapp/pair \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "ABC-1234"
  }'

{
  "channel": "whatsapp",
  "code": "ABC-1234",
  "status": "paired",
  "output": "Pairing approved successfully."
}
Approves a DM pairing request by submitting a pairing code. This is used when a channel requires explicit approval before the bot can interact with a user in direct messages.

​
Authentication

Requires an org-level API key or a scoped token with the channels permission.

​
Path Parameters

​
instance_id
string
required
The ID of the instance.
​
channel
string
required
The channel identifier.

​
Body Parameters

​
code
string
required
The pairing code to approve.

​
Response

​
channel
string
The channel identifier.
​
code
string
The pairing code that was submitted.
​
status
string
The result of the pairing attempt.
​
output
string
Additional output from the pairing process, if any.
curl -X POST https://api.chowder.dev/v1/instances/ins_abc123/channels/whatsapp/pair \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "ABC-1234"
  }'

{
  "channel": "whatsapp",
  "code": "ABC-1234",
  "status": "paired",
  "output": "Pairing approved successfully."
}