Developer docs

Developer docs for the MsgClub API

Send your first SMS in a few minutes with one HTTPS request, then add webhooks, WhatsApp, voice and IVR from the same account. Live endpoint, parameters, response codes and samples below.

  • REST API over HTTPS
  • SMPP for high volume
  • Webhooks for every channel
  • Unicode Hindi and regional SMS
Code editor with a cURL request to the MsgClub sendGroupSms endpoint, a message.delivered webhook payload and a note that response 3001 means the request was accepted

How do you send an SMS with the MsgClub API?

Send an HTTPS GET request to the MsgClub sendGroupSms endpoint with your AUTH_KEY, the message text, a DLT-approved sender ID, a route ID, one or more mobile numbers and the content type. A response code of 3001 means the request was accepted. Delivery results then appear in reports and can be sent to your webhook.

Base host
https://msg.msgclub.net/rest/services/
Auth
AUTH_KEY query parameter, unique per account
Success
Response code 3001: request accepted
Protocols
REST over HTTPS; SMPP
Samples
cURL, PHP, Python, Node.js, Java, C#, ASP.NET, VB.NET
Webhooks
message.*, call.*, ivr.input

Updated

Quick start: send an SMS

The sendGroupSms endpoint sends one message to one or many numbers. Replace YOUR_AUTH_KEY with your key and use a sender ID and template approved on DLT.

GET https://msg.msgclub.net/rest/services/sendSMS/sendGroupSms?AUTH_KEY=YOUR_AUTH_KEY&message=Hello&senderId=MSGCLB&routeId=1&mobileNos=9999999999&smsContentType=english

Live endpoint. URL-encode the message text, keep AUTH_KEY on your server, and test with your own number before sending in a loop, so a bug cannot use up your credits.

Which parameters does sendGroupSms take?

sendGroupSms parameters
ParameterTypeRequiredDescription
AUTH_KEYAlphanumericYesAuthentication key, unique to your account
messageTextYesMessage text, URL-encoded. Must match a DLT-approved template
senderIdTextYesYour DLT-approved sender ID (header), such as MSGCLB
routeIdIntegerYesThe route to send on, such as transactional or promotional. Use the route IDs enabled on your account
mobileNosNumber listYes, or groupIdOne or more mobile numbers, with or without country code, separated by commas
groupIdIntegerOptionalSend to a contact group saved in your MsgClub phonebook instead of listing numbers
smsContentTypeTextRecommendedenglish for plain text, unicode for Hindi and other Indian scripts

What do the API response codes mean?

Every response carries a code. 3001 means accepted; anything else tells you what to fix before retrying.

Common MsgClub API response codes
CodeMeaningWhat to check
3001Success Request acceptedTrack delivery in reports or by webhook
3002Invalid URLEndpoint path and query string
3003 / 3009Invalid user or authentication failedAUTH_KEY value and account status
3004Invalid message typesmsContentType is english or unicode
3005Invalid messageText, encoding and DLT template match
3006Invalid destinationMobile number format
3007Invalid sourceSender ID approved and mapped to your account
3010Internal errorRetry later with backoff; contact support if it repeats
3011Insufficient balanceRecharge credits in the panel
3014 / 3016Missing mobile number or required parameterAll required parameters are present
3018Expired accountAccount validity; talk to sales or support
3043 / 3044 / 3045Empty message, route ID or sender IDParameter values are not blank
3061Access deniedAPI access is enabled for your account

The full list of codes is in the API docs shared with your account.

How do you get delivery reports by webhook?

Register an HTTPS URL and MsgClub posts an event each time a message changes status. Reply with a 2xx code quickly, and store the event_id so a retried event is not processed twice.

The same events cover WhatsApp, RCS and voice. The full table of events by channel is on the API and webhooks page.

POST https://your-app.example.com/msgclub
Content-Type: application/json

{
  "event": "message.delivered",
  "event_id": "evt_41a0c2",
  "channel": "sms",
  "message_id": "m_88c1d0",
  "to": "+9198XXXXX210",
  "sender_id": "MSGCLB",
  "timestamp": 1763095811
}

Illustrative example. Exact endpoints and field names are in the API docs, shared when you get API access.

When should you use SMPP instead of REST?

Use the REST API for most applications: it is simple, works from any language and pairs with webhooks. Choose SMPP when you send very high SMS volumes, run an aggregator or reseller platform, or already have software that speaks SMPP. Ask our team for SMPP credentials, bind details and throughput for your account.

Resellers can also run their own branded panel on MsgClub. See the reseller program.

Which samples and plugins are available?

Sample code is available in PHP, Java, C#, ASP.NET and VB.NET, and any language that can make an HTTPS request works.

TallyBUSYMargFocus ERPGoogle SheetsZapierWHMCSMagentoUserlikeOlarkLiveChatChatra

Platform tools include DND filtering, HLR lookup and short URL click tracking.

How do you send your first SMS with the MsgClub API?

  1. Create an accountSign up for MsgClub and complete DLT registration details for your sender ID and templates.
  2. Copy your AUTH_KEYGet the authentication key for your account from the panel or from our team, and store it on your server.
  3. Build the requestAdd AUTH_KEY, message, senderId, routeId, mobileNos and smsContentType as URL-encoded query parameters to the sendGroupSms endpoint.
  4. Send and check the responseSend the request over HTTPS and check for response code 3001, which means the request was accepted.
  5. Track deliveryCheck delivery reports in the panel or receive message.delivered and message.failed events at your webhook.

Frequently asked questions

Where do I find my MsgClub AUTH_KEY?

Your AUTH_KEY is the authentication key unique to your MsgClub account. You can get it from the panel after signing up, or ask support to share it. Keep it on your server and never publish it in website code or a mobile app.

What does response code 3001 mean?

Response code 3001 means MsgClub accepted your request for sending. It does not yet mean the SMS reached the handset; delivery status follows in delivery reports in the panel and, if you have set one up, in a webhook to your system.

Do I need DLT registration to use the SMS API?

Yes. Under TRAI rules, business SMS in India must use a sender ID and message templates registered on a DLT platform. Your API message text must match an approved template, or operators will reject it.

Can I send Hindi or regional-language SMS through the API?

Yes. Set smsContentType to unicode and send the message in Hindi, Marathi, Tamil or any other Indian script. Unicode SMS carry fewer characters per part than English text, so long messages use more credits.

Does MsgClub support SMPP?

Yes. MsgClub supports SMPP for high-volume SMS and for systems that already use SMPP. Ask our team for SMPP account details, throughput and bind information when you plan your setup.

Which programming languages are supported?

Any language that can make an HTTPS request can use the REST API. This page shows cURL, PHP, Python, Node.js and Java, and sample code is also available for C#, ASP.NET and VB.NET.

How do I get API access for WhatsApp, voice and IVR?

Contact our team for API access. We share your API key and the documentation for each channel on your account, including exact endpoints, field names and webhook events.

Start sending in minutes

Create a free account to test the panel and API, or talk to our team about volumes, DLT setup and CRM integration.