Send Bulk SMS (POST)

curl --request POST \
  --url https://api.example.com/api/v2/SendBulkSMS \
  --header 'Content-Type: application/json' \
  --data '
{
  "SenderId": "<string>",
  "Messages": [
    {}
  ],
  "Messages[].Number": "<string>",
  "Messages[].Text": "<string>",
  "ApiKey": "<string>",
  "ClientId": "<string>"
}
'

import requests

url = "https://api.example.com/api/v2/SendBulkSMS"

payload = {
    "SenderId": "<string>",
    "Messages": [{}],
    "Messages[].Number": "<string>",
    "Messages[].Text": "<string>",
    "ApiKey": "<string>",
    "ClientId": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    SenderId: '<string>',
    Messages: [{}],
    'Messages[].Number': '<string>',
    'Messages[].Text': '<string>',
    ApiKey: '<string>',
    ClientId: '<string>'
  })
};

fetch('https://api.example.com/api/v2/SendBulkSMS', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ErrorCode": 123,
  "ErrorDescription": "<string>",
  "Data": [
    {}
  ],
  "Data[].MobileNumber": "<string>",
  "Data[].MessageId": "<string>"
}

curl --request POST \
  --url https://api.example.com/api/v2/SendBulkSMS \
  --header 'Content-Type: application/json' \
  --data '
{
  "SenderId": "<string>",
  "Messages": [
    {}
  ],
  "Messages[].Number": "<string>",
  "Messages[].Text": "<string>",
  "ApiKey": "<string>",
  "ClientId": "<string>"
}
'

import requests

url = "https://api.example.com/api/v2/SendBulkSMS"

payload = {
    "SenderId": "<string>",
    "Messages": [{}],
    "Messages[].Number": "<string>",
    "Messages[].Text": "<string>",
    "ApiKey": "<string>",
    "ClientId": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    SenderId: '<string>',
    Messages: [{}],
    'Messages[].Number': '<string>',
    'Messages[].Text': '<string>',
    ApiKey: '<string>',
    ClientId: '<string>'
  })
};

fetch('https://api.example.com/api/v2/SendBulkSMS', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "ErrorCode": 123,
  "ErrorDescription": "<string>",
  "Data": [
    {}
  ],
  "Data[].MobileNumber": "<string>",
  "Data[].MessageId": "<string>"
}

Send Bulk SMS (POST)

Send bulk SMS messages using the POST method with a JSON request body. This method is recommended for sending different messages to different recipients.

curl -X POST "https://app.notify.ng/api/v2/SendBulkSMS" \
  -H "Content-Type: application/json" \
  -d '{
    "SenderId": "YOUR_SENDER_ID",
    "Is_Unicode": true,
    "Is_Flash": false,
    "SchedTime": "",
    "Messages": [
      {
        "Number": "1234567890",
        "Text": "Hello John, your order is ready!"
      },
      {
        "Number": "0987654321",
        "Text": "Hello Jane, your appointment is tomorrow at 2 PM"
      }
    ],
    "ApiKey": "YOUR_API_KEY",
    "ClientId": "YOUR_CLIENT_ID"
  }'

const response = await fetch('https://app.notify.ng/api/v2/SendBulkSMS', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    SenderId: 'YOUR_SENDER_ID',
    Is_Unicode: false,
    Is_Flash: false,
    SchedTime: '',
    Messages: [
      {
        Number: '1234567890',
        Text: 'Hello John, your order is ready!'
      },
      {
        Number: '0987654321',
        Text: 'Hello Jane, your appointment is tomorrow at 2 PM'
      }
    ],
    ApiKey: 'YOUR_API_KEY',
    ClientId: 'YOUR_CLIENT_ID'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "https://app.notify.ng/api/v2/SendBulkSMS"
data = {
    "SenderId": "YOUR_SENDER_ID",
    "Is_Unicode": True,
    "Is_Flash": False,
    "SchedTime": "",
    "Messages": [
        {
            "Number": "1234567890",
            "Text": "Hello John, your order is ready!"
        },
        {
            "Number": "0987654321",
            "Text": "Hello Jane, your appointment is tomorrow at 2 PM"
        }
    ],
    "ApiKey": "YOUR_API_KEY",
    "ClientId": "YOUR_CLIENT_ID"
}

response = requests.post(url, json=data)
result = response.json()
print(result)

Request Body

string

required

Approved sender ID for the messages

array

required

Array of message objects

string

required

Mobile number for the message

string

required

Message text content

string

required

Your API key for authentication

string

required

Your client identifier for authentication

boolean

Set to true for Unicode messages (default: false)

boolean

Set to true for flash messages (default: false)

string

Schedule time in yyyy-MM-dd HH:MM format (optional)

Response

number

Error code (0 for success)

string

Description of the result

array

Array of message results

string

Mobile number that received the message

string

Unique message ID for tracking

Success Response

{
  "ErrorCode": 0,
  "ErrorDescription": "Success",
  "Data": [
    {
      "MobileNumber": "7894561230",
      "MessageId": "fc103131-5931-4530-ba8e-aa223c769536"
    },
    {
      "MobileNumber": "7894561231",
      "MessageId": "f893293d-d6ea-45e8-b543-40f0df28e0c9"
    }
  ]
}

Message Examples

Personalized Notifications

{
  "Messages": [
    {
      "Number": "1234567890",
      "Text": "Hi John, your order #12345 has been shipped!"
    },
    {
      "Number": "0987654321",
      "Text": "Hi Sarah, your order #12346 is ready for pickup!"
    }
  ]
}

Appointment Reminders

{
  "Messages": [
    {
      "Number": "1234567890",
      "Text": "Reminder: Your dental appointment is tomorrow at 10:00 AM"
    },
    {
      "Number": "0987654321",
      "Text": "Reminder: Your doctor appointment is tomorrow at 2:30 PM"
    }
  ]
}

Marketing Campaigns

{
  "Messages": [
    {
      "Number": "1234567890",
      "Text": "Hi John! Get 20% off your next purchase. Use code: SAVE20"
    },
    {
      "Number": "0987654321",
      "Text": "Hi Sarah! New arrivals in your favorite category. Shop now!"
    }
  ]
}

Use Cases

Personalized messaging: Send different messages to different recipients
Marketing campaigns: Targeted messages for different customer segments
Notifications: Different notification types for different users
Appointment reminders: Personalized reminders with specific details
Order updates: Different status updates for different orders
Event invitations: Personalized invitations with different details

Best Practices

Batch size: Keep batch sizes reasonable (100-500 messages per request)
Error handling: Handle individual message failures gracefully
Rate limiting: Respect API rate limits for bulk operations
Message validation: Validate message content before sending
Personalization: Use recipient data to personalize messages

Authentication

Credit Balance

SMS Management

Group Management

Sender ID Management

Template Management

Webhooks

Error Handling

Send Bulk SMS (POST)

Send Bulk SMS (POST)

Request Body

Response

Success Response

Message Examples

Personalized Notifications

Appointment Reminders

Marketing Campaigns

Use Cases

Best Practices

​Send Bulk SMS (POST)

​Request Body

​Response

​Success Response

​Message Examples

​Personalized Notifications

​Appointment Reminders

​Marketing Campaigns

​Use Cases

​Best Practices

Send Bulk SMS (POST)

Request Body

Response

Success Response

Message Examples

Personalized Notifications

Appointment Reminders

Marketing Campaigns

Use Cases

Best Practices