> ## Documentation Index
> Fetch the complete documentation index at: https://developers.vfbulk.ie/llms.txt
> Use this file to discover all available pages before exploring further.

# Delivery Receipts and Incoming SMS

> Reference for Vodafone Bulk Text delivery receipt and inbound SMS webhook payloads.

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`.

```text title="Callback URL" icon="server" wrap theme={"system"}
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

<CardGroup cols={2}>
  <Card title="Delivery Receipt" icon="receipt" href="/delivery-receipts-incoming-sms/delivery-receipt">
    Receive network-level delivery status for outbound SMS messages.
  </Card>

  <Card title="Incoming SMS" icon="inbox" href="/delivery-receipts-incoming-sms/incoming-sms">
    Receive inbound SMS replies, keyword messages, and opt-out messages.
  </Card>
</CardGroup>

## Download OpenAPI spec

<Card title="Download webhook OpenAPI spec" icon="file-code" href="/openapi/webhooks.yaml">
  Download `webhooks.yaml` for Delivery Receipts and Incoming SMS.
</Card>

<CardGroup cols={2}>
  <Card title="Download Delivery Receipt test spec" icon="file-code" href="/openapi/delivery-receipt-callback.yaml">
    Download the testable Delivery Receipt callback spec.
  </Card>

  <Card title="Download Incoming SMS test spec" icon="file-code" href="/openapi/incoming-sms-callback.yaml">
    Download the testable Incoming SMS callback spec.
  </Card>
</CardGroup>