Messages

Send SMS and WhatsApp messages, and retrieve message history across all channels.

The Messages API lets you send outbound SMS and WhatsApp messages to leads, and retrieve the full message history across all channels (SMS, WhatsApp, and email) for your workspace.

Send an SMS

Sends an SMS message to a phone number. By default, the message is sent from your workspace’s primary phone number.

to · string · required

Recipient phone number in E.164 format (e.g. "[phone]").

body · string · required

Message content. Maximum 1,600 characters. Messages longer than 160 characters are split into segments by the carrier.

from_number · string

Sender phone number to use. Must be a number registered in your workspace. Defaults to your workspace’s primary number.

cURL

curl -X POST https://api.boltcall.org/v1/messages/sms \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[phone]",
    "body": "Thanks for calling! Your appointment is confirmed for Friday at 10am."
  }'

Response

{
  "id": "msg_sms001",
  "channel": "sms",
  "status": "sent",
  "to": "[phone]",
  "created_at": "2025-03-20T15:00:00Z"
}

---

Send a WhatsApp message

Sends a WhatsApp message using an approved message template. Templates must be pre-approved through your WhatsApp Business Account before use.

to · string · required

Recipient phone number in E.164 format.

template · string · required

The approved WhatsApp template name (e.g. "appointment_reminder").

variables · object

Key-value pairs used to fill template placeholders. Keys match the variable names defined in the template.

WhatsApp only allows outbound messages using pre-approved templates. Contact your account manager to set up templates, or manage them in Integrations → WhatsApp.

cURL

curl -X POST https://api.boltcall.org/v1/messages/whatsapp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[phone]",
    "template": "appointment_reminder",
    "variables": {
      "customer_name": "Jane Smith",
      "appointment_time": "Friday at 10am"
    }
  }'

Response

{
  "id": "msg_wa001",
  "channel": "whatsapp",
  "status": "sent",
  "to": "[phone]",
  "created_at": "2025-03-20T15:05:00Z"
}

---

List messages

Returns paginated message history across all channels. Filter by channel or by a specific lead.

channel · string

Filter by messaging channel. Accepted values: "sms", "whatsapp", "email".

lead_id · string

Return only messages associated with a specific lead.

limit · integer

Number of results per page. Default: 20.

cURL

curl "https://api.boltcall.org/v1/messages?channel=sms&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "id": "msg_sms001",
      "channel": "sms",
      "direction": "outbound",
      "to": "[phone]",
      "body": "Thanks for calling! Your appointment is confirmed.",
      "status": "delivered",
      "created_at": "2025-03-20T15:00:00Z"
    }
  ],
  "meta": { "page": 1, "limit": 20, "total": 89 }
}

Show Response fields

id · string

Unique message identifier.

channel · string

Messaging channel: "sms", "whatsapp", or "email".

direction · string

"outbound" (sent by Boltcall) or "inbound" (received from the contact).

to · string

Recipient phone number or email address.

body · string

Message text content.

status · string

Delivery status: "sent", "delivered", or "failed".

created_at · string

ISO 8601 timestamp when the message was created.

Subscribe to the new_lead webhook event to receive real-time notifications when a new lead is captured, which includes the channel they contacted you through.