API Reference

Download OpenAPI specs

Download the source OpenAPI files for local tooling, contract review, or code generation.

Download the OAuth token, campaign, sender list, health, and processing webhook spec.

Download the v1 URL-encoded send message API spec.

Download the delivery receipt and inbound message webhook spec.

All API requests are made to:

Base URL

https://api.vodafone.com/api/v2

Authenticate by first obtaining an access token from:

Token endpoint

https://auth.vodafone.com/token

Then include the access token in the Authorization header on every API request:

Authorization header

Authorization: Bearer YOUR_ACCESS_TOKEN

The OAuth token endpoint uses application/x-www-form-urlencoded. Campaign endpoints use JSON with Content-Type: application/json.

Code	Meaning
`200`	OK — request succeeded
`400`	Bad Request — invalid parameters or validation errors
`401`	Unauthorized — invalid or missing access token
`415`	Unsupported Media Type — use the required content type
`500`	Internal Server Error

Last modified on May 6, 2026