API for sending SMS messages

📬 The Send Api, version 2.0

 

Got an SMS message to send? Our Sending SMS API makes it quick and easy to fire off transactional or marketing sms messages to your audience, right from your app or backend.

Whether you're confirming a purchase, sending a welcome message, or saying “Hey, we miss you,” this API has your back.

 

🔐 Step 1: Get Your Api Key

Before anything else, you’ll need an Api key to authenticate your requests.
Already have one? Great! Copy it to your clipboard.
Need one? You can generate it by heading over to Settings → Api Keys → Create New Api Key.

 

📨 Step 2: Add Your Api Key to the Request Header

When you’re ready to make your request, add your Api key into the header like this:

x-api-key: xxxx-xxxx-xxxx-xxxx
📋 Copy

 

🚀 Step 3: Send a POST Request to this endpoint

You’ll be sending a POST request to:

https://inbound.messengeros.com/2.0/send
📋 Copy

This is where the magic happens ✨

 

🧱 Step 4: Build your Payload


4.1. Send SMS messages using templates created in MessengerOS

Here’s the format your JSON payload should follow:
Mandatory fields: phone_number. 
{
    "project": "xxxxxx-xxxxxx-xxxx-xxxxx-xxxxxxxxx", // optional (if missing, the default Project will be used), can be found in Settings / Projects / Edit / Show Api Key
    "notification": {
        "sms": [
            {
                "delivery_provider": "xxxxxx-xxxxxx-xxxx-xxxxx-xxxxxxxxx",// can be found in Settings / Projects / Edit / Delivery Channel / Show Api Key
                "template": "xxxxxx-xxxxxx-xxxx-xxxxx-xxxxxxxxx",
                "recipients": [
                    {
                        "phone_number": "+407xxxxxxxx",
                        "notification_origin_id": "xxxxxx", // a client generated unique id that we are going to use for webhooks, when sending back the status of the notification
                        "name": "Recipient's full name (First name + Last name) or Company name", // optional, if you want to save the recipient's full name or company name
                        "first_name": "Recipient's first name", // optional, if you want to save the recipient's first and last name separately
                        "last_name": "Recipient's last name", // optional, if you want to save the recipient's first and last name separately
                        "distribution_lists": [
                            "xxxxxx-xxxxxx-xxxx-xxxxx-xxxxxxxxx"
                        ], // optional, can be found in Audience / Lists / Edit / Show Api Key
                        "custom_info": [
                            {"key1": "value1"},
                            {"key2": "value2"},
                            {"key3": "value3"}
                        ] // optional, will be found in Audience / Contacts / View
                    }
                ],
                "params": [
                    {"FIRST_NAME": "Alex"},
                    {"APP_NAME": "my_assista"},
                    {"AMOUNT": "23"}
                ] // optional (if missing the default project will be used), can be found in Settings / Projects / Edit / Show Api Key
            }
        ]
    }
}
📋 Copy

4.2. Send SMS messages with pre-built message

Here’s the format your JSON payload should follow:
Mandatory fields: phone_number. 
{
    "project": "xxxxxx-xxxxxx-xxxx-xxxxx-xxxxxxxxx", // optional (if missing, the default Project will be used), can be found in Settings / Projects / Edit / Show Api Key
    "notification": {
        "sms": [
            {
                "delivery_provider": "xxxxxx-xxxxxx-xxxx-xxxxx-xxxxxxxxx",// can be found in Settings / Projects / Edit / Delivery Channel / Show Api Key
                "recipients": [
                    {
                        "phone_number": "+407xxxxxxxx",
                        "notification_origin_id": "xxxxxx", // a client generated unique id that we are going to use for webhooks, when sending back the status of the notification
                        "name": "Recipient's full name (First name + Last name) or Company name", // optional, if you want to save the recipient's full name or company name
                        "first_name": "Recipient's first name", // optional, if you want to save the recipient's first and last name separately
                        "last_name": "Recipient's last name", // optional, if you want to save the recipient's first and last name separately
                        "distribution_lists": [
                            "xxxxxx-xxxxxx-xxxx-xxxxx-xxxxxxxxx"
                        ], // optional, can be found in Audience / Lists / Edit / Show Api Key
                        "custom_info": [
                            {"key1": "value1"},
                            {"key2": "value2"},
                            {"key3": "value3"}
                        ] // optional, will be found in Audience / Contacts / View
                    }
                ],
                "sms_body": "Hello *|first_name|*, please leave us a review",
                "params": [
                    {"first_name":"Recipient's first name"}
                ] // optional
            }
        ]
    }
}
📋 Copy

 

✅ Step 5: Get a Confirmation

If everything looks good and your JSON is valid, the Api will respond with: 

{"status": "received"}

This means we’ve accepted the request and your subscriber is being processed in the background.

 

👀 Step 6: Double check in your Audience lists

Once your request goes through, head over to SMS → Sent SMSes to confirm that your SMS has been sent to specified recipient.
That’s it! 🎉

Need help or want to test it out? Let us know, we’re always here to support.

© MessengerOS