Skip to main content
This guide walks you through sending your first message using Sling API v2. You will get your API token, register a sender ID, send a message, and confirm delivery — all in a few minutes.
1

Get your API token

Log in to your dashboard and visit Account → API to copy your API token.You can also exchange an email and password for a token through POST /auth:
cURL
curl --request POST \
  --url https://app.sling.com.ng/api/v2/auth \
  --header "Accept: application/json" \
  --header "Content-Type: application/json" \
  --data '{ "email": "[email protected]", "password": "your-password" }'
See Authentication for a detailed walkthrough.
2

Register a sender ID

A sender ID is the name or number your recipients see as the message source. You must register one before sending.Visit Sender IDs in your dashboard to register a sender ID. Once approved, use that name as the sender value in your API requests. Each channel (SMS, RCS, Truecaller, WhatsApp, Email) requires its own approved sender.
3

Send your first message

The fastest path is the universal endpoint, which routes by channel:
cURL
curl --request POST \
  --url https://app.sling.com.ng/api/v2/send \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "channel": "sms",
    "to": "2349123772222",
    "message": "Hello, from Sling v2!",
    "sender": "YourSenderID"
  }'
Set channel to sms, rcs, truecaller, whatsapp, or email to switch channels without changing the URL.A successful single-recipient request returns 200 OK with a body similar to:
{
  "status": "success",
  "status_delivery": "delivered",
  "message_id": "2bajqzt5tw",
  "sender": "YourSenderID",
  "message": "Hello, from Sling v2!",
  "recipient": "2349123772222",
  "credit_used": 1
}
Save the message_id value — you will need it to check delivery status.
Each message consumes credit from your balance. The credit_used field tells you how many credits were deducted. Check your remaining balance any time with GET /balance.
4

Check message status

Use your message_id to confirm delivery:
cURL
curl --request GET \
  --url https://app.sling.com.ng/api/v2/status/2bajqzt5tw \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_API_TOKEN"
A successful response looks like this:
{
  "status": "sent",
  "status_delivery": "delivered",
  "message_id": "2bajqzt5tw",
  "credit_used": 1,
  "sender": "YourSenderID",
  "recipient": "2349123772222",
  "message_history": [
    { "status": "delivered", "datetime": "2026-05-09T12:34:56Z" }
  ],
  "updated_at": "2026-05-09T12:34:56Z"
}
The status_delivery field confirms whether the message reached the recipient’s handset.

​
Next steps

You have sent your first v2 message. Explore the rest of the API to add richer messaging to your application:

Universal send

Use one endpoint for SMS, RCS, Truecaller, WhatsApp, and Email.

Send RCS

Cards, carousels, images, and interactive suggestions.

Contacts

Manage groups and contacts to target lists with one call.