Skip to main content

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.

Download OpenAPI specs

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

OAuth and campaign API

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

Legacy URL-encoded API

Download the v1 URL-encoded send message API spec.

Delivery and inbound webhooks

Download the delivery receipt and inbound message webhook spec.

Base URL

All API requests are made to:
Base URL
https://api.vodafone.com/api/v2

Authentication

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

Request format

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

Response codes

CodeMeaning
200OK — request succeeded
400Bad Request — invalid parameters or validation errors
401Unauthorized — invalid or missing access token
415Unsupported Media Type — use the required content type
500Internal Server Error
Last modified on May 6, 2026