SMS

Send SMS

Send a message to one or multiple recipients. Supports scheduling, DND bypass, and URL shortening via the options object.

POST

/v1/sms/send

Authorization

Header

X-Emisri-Api-Key: your_secret_key

Required

Yes

Request body

application/json

Field	Type	Required	Description
sender	string	yes	Your registered Sender ID (max 11 characters).
text	string	yes	The SMS message content.
destination	array	yes	One or more recipient phone numbers in international format without the + sign (e.g. 2348012345678).
campaignName	string	no	A label for grouping messages. A campaignId is returned in the response for analytics.
options	object	no	Optional configuration for scheduling, DND bypass, and URL shortening. See Options object below.

options object

Field	Type	Required	Description
scheduleAt	string	no	ISO 8601 datetime to schedule the message (e.g. 2026-05-21T09:00:00Z). Omit to send immediately.
excludeDnd	boolean	no	Set to true to bypass Do Not Disturb restrictions for this message.
urlShortening	object	no	URL shortening and click-tracking configuration. See urlShortening object below.

Response · 200 OK

application/json

Field	Type	Required	Description
success	boolean	—	true when the request was accepted successfully.
data	object	—	The response payload.
meta	object	—	Request metadata.

Request Samples

Request · single / bulk

const response = await fetch('https://BASE_URL/v1/sms/send', {
  method: 'POST',
  headers: {
    'X-Emisri-Api-Key': 'your_secret_key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    sender: 'YourSenderId',
    text: 'Hi, your order is ready',
    destination: ['2348012345678'],
  }),
})
const data = await response.json()

Response Samples

Response · 200 OK

{
  "success": true,
  "data": {
    "campaignId": "5f10dcb7-2f0b-430a-b55d-cd6e00b90b1b",
    "summary": {
      "totalRecipients": 2,
      "validDestination": 2,
      "invalidDestination": 0
    }
  },
  "meta": {
    "requestId": "req__8IRqwWfkb1SepPP"
  }
}