API Reference

Messages

Send Message

Send a text, media, or document message to a WhatsApp number.

curl -X POST "https://api.sendable.dev/messages/send" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "6281234567890",
    "text": "Hello from Sendable"
  }'

Request Body:

Field	Type	Required	Description
`to`	string	Yes	Recipient phone number with country code
`text`	string	Yes*	Message text (required if no media)
`mediaUrl`	string	No	URL to media file
`mediaType`	string	No	`image`, `video`, `audio`, `document`
`caption`	string	No	Caption for media messages

Response:

{
  "success": true,
  "messageId": "msg_abc123",
  "status": "pending"
}

Sessions

Get Session Status

curl -X GET "https://api.sendable.dev/sessions/{sessionId}/status" \
  -H "x-api-key: YOUR_API_KEY"

Response:

{
  "sessionId": "sess_xyz789",
  "status": "connected",
  "connectedAt": "2026-03-02T10:30:00Z",
  "health": "healthy"
}

Groups

List Group Or Community Audit Logs

Use the same group endpoint for standard groups and WhatsApp communities. Communities are represented as groups with isCommunity = true.

curl -X GET "https://api.sendable.dev/v1/groups/[email protected]/logs?limit=25&eventKey=group-participants.update" \
  -H "x-api-key: YOUR_SESSION_API_KEY"

Response:

{
  "data": [
    {
      "id": "log_123",
      "groupId": "[email protected]",
      "eventKey": "group-participants.update",
      "action": "add",
      "authorId": "[email protected]",
      "authorJid": "[email protected]",
      "authorLid": null,
      "participants": [
        {
          "id": "[email protected]",
          "jid": "[email protected]",
          "phoneNumber": "6289876543210"
        }
      ],
      "leftAtBefore": null,
      "leftAtAfter": null,
      "payload": {},
      "createdAt": "2026-03-14T08:10:00.000Z"
    }
  ],
  "nextCursor": null
}

Webhooks

List Webhooks

curl -X GET "https://api.sendable.dev/webhooks" \
  -H "x-api-key: YOUR_API_KEY"

Create Webhook

curl -X POST "https://api.sendable.dev/webhooks" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-app.com/webhook",
    "events": ["message.delivered", "message.read"]
  }'

On this page