API v1

Small surface area. Predictable integration.

All protected endpoints use a bearer API key created from your dashboard.

Authentication

Authorization: Bearer alma_xxxxxxxxxxxxxxxxx

Keys are shown once at creation time. The platform stores only a SHA-256 hash.

List accounts

GET /api/v1/accounts

Send a text message

POST /api/v1/messages
Content-Type: application/json

{
  "account_id": 12,
  "to": "923001234567",
  "type": "text",
  "text": "Hello from ALMA WhatsApp API"
}

Supported initial types: text, image, video, audio, document, interactive and template.

Reply to a specific message

{
  "account_id": 12,
  "to": "923001234567",
  "type": "text",
  "text": "Thanks — I found your order.",
  "reply_to_message_id": "wamid.HBgM..."
}

Reply buttons

{
  "account_id": 12,
  "to": "923001234567",
  "type": "interactive",
  "text": "What would you like to do?",
  "buttons": [
    {"id":"track","title":"Track order"},
    {"id":"support","title":"Support"}
  ]
}

Outgoing webhooks

Every delivery contains X-ALMA-Event and X-ALMA-Signature headers.

message.received
message.sent
message.delivered
message.read
message.failed