Incoming SMS
Vodafone sends this inbound SMS relay payload to your configured callback URL via HTTP POST.
In the API playground, replace callbackUrl with the URL for your test
endpoint. The example default is https://callback.yourcompany.com.
Your endpoint must accept application/x-www-form-urlencoded POST
requests and return 200 OK after accepting the payload.
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.
Body
Inbound SMS relay payload sent by Vodafone to a customer callback URL for replies, keyword messages, and opt-outs.
Message type. AuthCode is the standard inbound relay type; Text may appear in some legacy configurations.
AuthCode, Text Full inbound SMS message body.
"Test reply"
"Optout"
First word of the message, used for keyword routing. * means no specific keyword was matched.
"*"
"CONFIRM"
"STOP"
Sender mobile number in GSM format.
"353896073106"
Number the message was sent to. Opt-out payloads use shared shortcode 50123.
"353870934726"
"50123"
notifyId from the original outbound message where Vodafone can correlate the reply; otherwise an empty string.
"order-001"
""
MD5 verification hash for confirming the relay came from Vodafone.
"5b49b61a65520226f3da14764f7c182b"
Gateway receipt time, formatted as yyyy-MM-dd HH:mm:ss.
^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$"2026-04-09 16:03:11"
Network code in MCC/MNC format. For Irish numbers, MCC is 272. This field may be empty depending on network and message type.
"272/1"
""
Legacy routing code used by older integrations. Ignore in new builds.
"AUTH:reply/1450707"
Legacy group routing code used by older integrations. Ignore in new builds.
"AUTH:G353870934726/*"
Response
Your callback endpoint accepted the inbound SMS payload.