Skip to main content
Use these webhook definitions when Vodafone sends delivery receipts or inbound SMS relays to your own callback endpoint. These callbacks are separate from the V2 OAuth API SMS Processing Result webhook. Processing Result confirms whether Vodafone accepted or rejected an API send request. Delivery Receipts and Incoming SMS describe downstream network delivery events and inbound messages sent back to your configured endpoint.

​
Callback server

You provide the callback URL when Vodafone configures your account. The API reference pages let you test the payload shape against a full callback URL, without adding a fixed path such as /delivery-receipt or /incoming-sms.
Callback URL
https://callback.yourcompany.com
In the generated reference, replace callbackUrl with your test endpoint or production callback URL before sending a test request. Your endpoint must accept HTTP POST requests and return 200 OK after the payload has been accepted for processing.

​
Available webhooks

Delivery Receipt

Receive network-level delivery status for outbound SMS messages.

Incoming SMS

Receive inbound SMS replies, keyword messages, and opt-out messages.

​
Download OpenAPI spec

Download webhook OpenAPI spec

Download webhooks.yaml for Delivery Receipts and Incoming SMS.

Download Delivery Receipt test spec

Download the testable Delivery Receipt callback spec.

Download Incoming SMS test spec

Download the testable Incoming SMS callback spec.
Last modified on May 6, 2026