Looking for a MessageMedia page? If you are and were redirected here, it’s because MessageMedia is rebranding to Sinch Engage. Learn more about our rebrand

MESSAGES API

Send & receive SMS with the Messages API

Send SMS and MMS from one API. Get delivery reports and two-way replies with a single request.

Get started
View documentation
Image for Send & receive SMS with the Messages API

Built for reliable delivery

Your messages get delivered on a network Sinch owns and runs. Multiple data centres and automatic re-routing keep messages moving, even when a carrier goes down.

99.99%
network uptime
5B+
messages sent per year
2,000
messages processed per second

Manage the full message lifecycle

Send SMS and MMS messages, then follow them end to end, from schedule to reply.

Get started
Image for Manage the full message lifecycle

Send

Send SMS and MMS with one request. Set the content, destination number, and format.

Schedule

Set a future delivery time for things like appointment reminders. Cancel a scheduled message before it goes out.

Reply

Retrieve two-way replies from your recipients. Confirm the ones you’ve handled so they aren’t returned again.

Track

Check any message’s status with its ID. Get delivery reports pushed to you as the status changes.

Start using the Messages API

Follow these five steps to send your first message.

Sign up for Sinch Engage and verify your account. A verified account is required to create API keys.

In the platform, go to Settings, then API Settings, and create a Basic key (admin access required). Copy the secret; it shows only once.

Make a request that includes the message content and destination number.

The API returns a message ID. Use it to track the message.

Check a message’s status, retrieve replies, and confirm them. Set up a webhook to get updates pushed to you.

View documentation 
                            

                                curl -X POST https://eu.app.api.sinch.com/v1/messages \
  -u "API_KEY:API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "content": "Hello World",
        "destination_number": "+61491570156",
        "format": "SMS"
      }
    ]
  }'

How the Messages API fits into your stack

Connect the API to your systems with standard HTTP and a few built-in tools.

  • Webhooks – Get status, replies, and delivery reports pushed to your URL. 

  • Metadata – Attach key-value pairs to each message. 

  • Sub-accounts – Act on behalf of child accounts with one parent key. 
  • Regions – Send from EU or APAC data centres.   
Image for How the Messages API fits into your stack

More than a messaging API

The same platform gives you the APIs around messaging, not just the send.

  • Contacts – Manage contacts, lists, and custom fields.
  • Numbers – Buy and configure dedicated numbers. 
  • Reporting – Pull delivery and engagement reports. 
  • Security – Sign requests with HMAC, and verify that callbacks come from Sinch with signature keys.   
Talk to an expert
Image for More than a messaging API

WHY SINCH ENGAGE?

The app and the API, together

Sinch Engage pairs an easy-to-use app with a full API. Business teams launch messaging without writing code. Developers get the control and endpoints they need.

You don’t have to choose between usability and depth. You get both, on a network built for reliable delivery.

Image for The app and the API, together

FAQ

Frequently asked questions about the Messages API

The Sinch Engage Messages API is a REST API for sending and receiving SMS and MMS messages. You can send messages, schedule them, track delivery, and handle two-way replies with standard HTTP requests.

Send an SMS by making a POST request to the Sinch Engage Messages API with your API key. Include the message content and destination number. The API returns a message ID you can use to track delivery.

Yes. The Sinch Engage Messages API sends both SMS and MMS. For MMS, add a subject line and media URLs to your message.

Retrieve inbound replies from the Sinch Engage Messages API, then confirm them so they are not returned again. You can also receive replies in real time by setting a webhook URL.

Yes. Set a future delivery time when you send a message. You can cancel a scheduled message any time before it goes out.

Every message returns a message ID. Use it to check the message status, or request delivery reports to get status changes as they happen.

Authenticate every request to the Sinch Engage Messages API with Basic authentication or an HMAC signature. To confirm that callbacks come from Sinch, create a signature key pair and verify the signature on each callback you receive.