> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.conversive.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.conversive.ai/_mcp/server.

# Push Webhooks

SMS Magic pushes delivery reports and incoming messages to your registered URL.

> **Note**
>
> If your URL is behind a firewall, whitelist the IP `34.197.38.71`.

## Delivery reports

`POST <your_registered_url>`

SMS Magic pushes this payload when a delivery report is received:

```json
{
  "id": "4e770fca-8c68-44e3-901e-9c13e3149945",
  "delivery_status": "success",
  "timestamp": "2020-07-24T02:49:31.757447",
  "mobile_number": "9891989898",
  "label": "marketing"
}
```

| Name              | Type   | Description                        |
| ----------------- | ------ | ---------------------------------- |
| `id`              | string | SMS identifier.                    |
| `delivery_status` | string | Delivery status of the SMS.        |
| `timestamp`       | string | Timestamp of delivery.             |
| `mobile_number`   | string | Mobile number the SMS was sent to. |
| `label`           | string | Label used to send the SMS.        |

## Incoming SMS

`POST <your_registered_url>`

SMS Magic pushes this payload when an incoming message is received:

```json
{
  "id": "fcd70fca-8c68-44e3-901e-9c13e3149945",
  "sent_from": "9891989898",
  "sent_to": "124128",
  "msg": "Hello World",
  "timestamp": "2020-07-24T02:49:31.757447"
}
```

| Name        | Type   | Description                          |
| ----------- | ------ | ------------------------------------ |
| `id`        | string | SMS identifier.                      |
| `sent_from` | string | Number the SMS was sent from.        |
| `sent_to`   | string | Number the SMS was sent to.          |
| `msg`       | string | SMS text.                            |
| `timestamp` | string | Timestamp when the SMS was received. |