Webhooks Overview

Webhooks allow you to receive real-time notifications about events happening in your SendAPI account. Instead of polling the API for status updates, SendAPI will push relevant data to your server as HTTP POST requests.

Use Cases

• Delivery Receipts: Get notified when an SMS or WhatsApp message is delivered or read.
• Inbound Messages: Receive messages sent by your customers to your WhatsApp or SMS numbers.
• Email Tracking: Receive events when an email is opened or a link is clicked.

Configuration

You can configure your global webhook URL in the Dashboard Settings. Additionally, some endpoints allow you to specify an callback_url to override the global setting for a specific request.

Subscription Requirement

Paid Feature

Webhooks are a premium feature and require a paid subscription. Webhook notifications are not dispatched for accounts currently on the 3-day free trial. Upgrade your plan in the Billing section to enable real-time events.

Event Payload Format

All webhook requests follow a standardized format:

{
  "id": "evt_01H8BKF...Z2T",
  "type": "sms.delivered",
  "data": {
    "id": "sms_...",
    "to": "+1234567890",
    "status": "delivered",
    "delivered_at": "2026-03-09T14:35:00Z"
  },
  "created_at": "2026-03-09T14:35:01Z"
}