📦
Mobivate Bulk API Documentation
  • 👋Welcome to BulkSMS
  • AUTHENTICATION & INTEGRATION
    • Getting started with Integration
      • Creating a New API Key
      • Get API Key
      • Test API Key
    • Registering Webhooks
      • Delivery Receipt Notification
      • Incoming Message Notification
      • Short URL Click Notification
    • Understanding Response Codes
  • USE CASES
    • Send Single SMS Message
      • Understanding SMS Response Codes
    • Send Batch SMS Messages
      • Understanding Batch SMS Response Codes
    • Search Message logs
    • Search for Single Message log
    • List OptOuts
    • Add an OptOut
    • Delete an OptOut
    • Frequently Asked Questions
  • 📚Integrations
    • Integrating Mobivate framework into your own application
    • Automate SMS messages using events through Zapier
    • Asynchronous Number Verification
    • Synchronous Number Verification
    • Adding / Removing Contacts
    • Creating New Contact Group
  • 🔓ARCHIVED DOCS
    • Sending simple Notification messages
    • Sending SMS from 3rd Party Providers
    • Sending Campaigns
Powered by GitBook
On this page
  • Responses
  • Sample Success Response
  • Sample Error Response
  • Response Codes

Was this helpful?

  1. USE CASES
  2. Send Single SMS Message

Understanding SMS Response Codes

This document goes over understanding SMS responses using our API.

Responses

We use conventional HTTP response codes to indicate the success or failure of an API request. In general:

2xx indicate success. 4xx indicate an error that failed given the information provided (e.g., a required parameter was omitted). 5xx errors indicate an error with ours servers (these are rare).

Sample Success Response

Upon a successful send request, our server will respond with a 200 (success) HTTP response code, and you will be provided with a message record which includes our ID.

{
   "id":"ef5796ce-e326-4a09-9033-6b457039b1ba",
   "originator":"Test",
   "recipient":"44700011122",
   "body":"This is a test message",
   "routeId":"mglobal",
   "reference":null,
   "campaignId":null
}

Sample Error Response

{
   "code":401,
   "message":"Unauthorized"
}
{
   "code":403,
   "message":"Recipient is opted out: 44XXXXXXXX"
}

Response Codes

PreviousSend Single SMS MessageNextSend Batch SMS Messages

Last updated 1 year ago

Was this helpful?

To see a full list of our Response codes, please

click here