Sending a Message

Now that you have your Account API key, you can authenticate against the message endpoints.

The preferred endpoint for sending messages is add-message.

Add a Message to the queue

Messages in our API get placed into a queue, allowing us to accept a higher message throughput. The add-message endpoint pushes a new message into the queue for processing.

To test your implementation, you can queue an SMS to your personal mobile device, by making a POST request to the add-message endpoint.

---

POST https://mplus.instagiv.com/message

{
    "messages": [
        {
            "from": {
                "type": "custom",
                "value": "mplus-test"
            },
            "to": "441111111111",
            "body": "This is a test message!"
        }
    ]
}

---

response body

{
    "messages": [
        {
            "to": "441111111111",
            "body": "This is a test message!",
            "from": {
                "type": "custom",
                "value": "mplus-test"
            },
            "batchUuid": "c4ae0c8a-bbb2-4ce3-8ebc-5d8df1751d8d",
            "messageUuid": "c385bb6e-32f0-4952-a198-c5ed2a00161b",
            "scheduled": false
        },
    ]
}

---

We return two identifiers for your message - the Batch UUID and the Message UUID. Both will identify your message, but when using the add-message endpoint, the Message UUID is most important to record.

This covers the basics of sending using the Messaging Plus API!

Next steps

The rest of this guide covers message scheduling, delivery receipts, and handling inbound SMS.