> ## 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. # Send Message (URL-Encoded) > Send a Vodafone Bulk Text SMS message using `application/x-www-form-urlencoded` form fields. You must include your Vodafone Bulk Text username, password, and API ID with each request. URL encode every value before submitting the request, especially customer-facing message text and scheduled send dates. Use this endpoint for practical business communication such as customer alerts, appointment reminders, staff updates, promotions, and time-sensitive service messages. ## OpenAPI ````yaml POST /sendmessage.aspx openapi: 3.1.0 info: title: Vodafone Bulk Text Send Message API version: 1.12.0 description: > Reach customers, colleagues, and stakeholders quickly with Vodafone Bulk Text. Use this API to send secure, reliable SMS messages directly from your application, CRM, or customer database. Submit URL-encoded form fields to send a message now, schedule it for later, or label it for easier reporting. contact: name: Vodafone Bulk Text Support email: bulktext.ie@vodafone.com x-brand: name: Vodafone Ireland voice: Confident, direct, practical, and business-focused. tone: - Clear and action-oriented. - Security-aware without sounding alarmist. - Commercially focused, with emphasis on reliable customer communication. - Short, scannable wording that helps customers complete the task. colors: primary: '#E60000' secondary: '#121212' surface: '#F2F2F2' text: '#0D0D0D' error: '#D93025' typography: primaryFamily: Vodafone, Open Sans, sans-serif style: Compact, legible, and conversion-focused. servers: - url: http://bulktext.vodafone.ie/HTTP_API/V1 description: Vodafone Bulk Text URL-encoded API security: [] tags: - name: Send Message description: Send reliable SMS messages through Vodafone Bulk Text. paths: /sendmessage.aspx: post: tags: - Send Message summary: Send an SMS message description: > Send a Vodafone Bulk Text SMS message using `application/x-www-form-urlencoded` form fields. You must include your Vodafone Bulk Text username, password, and API ID with each request. URL encode every value before submitting the request, especially customer-facing message text and scheduled send dates. Use this endpoint for practical business communication such as customer alerts, appointment reminders, staff updates, promotions, and time-sensitive service messages. operationId: sendMessage requestBody: required: true content: application/x-www-form-urlencoded: schema: oneOf: - $ref: '#/components/schemas/SendMessageForm' examples: basicMessage: summary: Send a customer update now value: > user=XXXX&password=XXXXXXXX&api_id=1234&to=353879999999&text=Hello%20World&from=YourCompany scheduledByDelay: summary: Schedule a message by delay value: > user=XXXX&password=XXXXXXXX&api_id=1234&to=353879999999&text=Hello%20World&from=YourCompany&DeliveryTime=120 scheduledByDate: summary: Schedule a message by date and time value: > user=XXXX&password=XXXXXXXX&api_id=1234&to=353879999999&text=Hello%20World&from=YourCompany&SMS-SendAt=2026-04-04%2011%3A45 messageWithNotifyId: summary: Add your own tracking reference value: > user=XXXX&password=XXXXXXXX&api_id=1234&to=353879999999&text=Hello%20World&from=YourCompany&NotifyID=XXXXXX futureMessageWithNotifyId: summary: Schedule a tracked message value: > user=XXXX&password=XXXXXXXX&api_id=1234&to=353879999999&text=Hello%20World&from=YourCompany&NotifyID=XXXXXX&DeliveryTime=120 campaignName: summary: Label a message for reporting value: > user=XXXX&password=XXXXXXXX&api_id=1234&to=353879999999&text=Hello%20World&from=YourCompany&BroadcastName=May%20Discount%20Campaign responses: '200': description: > Vodafone Bulk Text returns a plain-text confirmation or validation message. Review the response body to confirm whether the message was accepted, queued, or needs attention. content: text/plain: schema: type: string examples: successDeferred: summary: Message accepted for delivery value: | 0 Request deferred successfully invalidMsisdns: summary: Check the recipient numbers value: > 1 Error With Query String. No valid MSISDNS found. Invalid numbers found > {numbers} genericQueryError: summary: Check the request parameters value: | 1 Error With Query String invalidUser: summary: Check your username and password value: | 7 Username and Password don't match any client. notEnoughCredit: summary: Add credit before sending value: | 5 Not enough credit senderIdUnregistered: summary: Register this Sender ID before sending value: > 5 SenderID requires registration, contact bulktext.ie@vodafone.com fromRequired: summary: Add a Sender ID value: | 5 The 'From' field is required and cannot be left blank emptyText: summary: Add message text value: | 5 Content text is empty longText: summary: Shorten the message text value: | 5 Message can't be more than 160 characters validationError: summary: Review the request details value: | 5 Error in Validate: {message} messageFailed: summary: Message was not sent value: | 5 Message couldn't be sent invalidFormat: summary: Check the request format value: | 8 Invalid string format. security: [] components: schemas: SendMessageForm: type: object description: > URL-encoded fields for sending a Vodafone Bulk Text SMS message from your business system. properties: user: type: string description: Your Vodafone Bulk Text API username. examples: - User1 password: type: string format: password description: >- Your Vodafone Bulk Text API password. Keep this secure and do not share it. examples: - Password1 api_id: type: string description: >- Your unique API ID, supplied when your Vodafone Bulk Text account is set up. examples: - '9876' to: type: string description: > Recipient mobile number in GSM/international format. Use commas to send the same message to multiple customers or colleagues. examples: - '353871111111' text: type: string minLength: 1 maxLength: 160 description: > Customer-facing SMS message text. Keep it clear, concise, and within 160 characters. Replace new lines with ASCII 172 before submitting the request; Vodafone Bulk Text converts them back to new lines when the message is sent. examples: - HelloWorld from: type: string maxLength: 11 description: > Sender ID displayed on the recipient handset. Use a Sender ID that has been configured for your Vodafone Bulk Text account. Alphanumeric Sender IDs can be up to 11 characters and must not contain spaces. examples: - YourCompany NotifyID: type: string maxLength: 30 description: > Optional reference you can use to track the message in your own systems. Use alphanumeric characters only. examples: - '321354' BroadcastName: type: string maxLength: 200 default: API Broadcast description: > Optional campaign name to help your team identify the message in reports. This value is not included in the SMS message. examples: - May Discount Campaign DeliveryTime: type: integer minimum: 1 description: > Optional number of minutes to wait before sending the message. Use this when timing matters, such as reminders, alerts, or planned promotions. For example, use 120 to send the message in two hours. examples: - 120 SMS-SendAt: type: string pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}$ description: > Optional scheduled send date and time in 24-hour `yyyy-MM-dd HH:mm` format. Use this for planned customer communications. examples: - 2026-04-04 11:45 required: - user - password - api_id - to - text - from ````