Skip to navigation

Push Webhooks

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

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:

{
"id": "4e770fca-8c68-44e3-901e-9c13e3149945",
"delivery_status": "success",
"timestamp": "2020-07-24T02:49:31.757447",
"mobile_number": "9891989898",
"label": "marketing"
}
NameTypeDescription
idstringSMS identifier.
delivery_statusstringDelivery status of the SMS.
timestampstringTimestamp of delivery.
mobile_numberstringMobile number the SMS was sent to.
labelstringLabel used to send the SMS.

Incoming SMS

POST <your_registered_url>

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

{
"id": "fcd70fca-8c68-44e3-901e-9c13e3149945",
"sent_from": "9891989898",
"sent_to": "124128",
"msg": "Hello World",
"timestamp": "2020-07-24T02:49:31.757447"
}
NameTypeDescription
idstringSMS identifier.
sent_fromstringNumber the SMS was sent from.
sent_tostringNumber the SMS was sent to.
msgstringSMS text.
timestampstringTimestamp when the SMS was received.