Skip to main content

​
Prerequisites

Before you begin, you’ll need:
  1. An account on our messaging platform
  2. A workspace created in your dashboard
  3. Your messaging provider configured

​
Step 1: Get your API key

Navigate to your workspace settings and generate an API key.
Keep your API key secure and never commit it to version control.

​
Step 2: Send your first message

Use your API key to send a message: 
curl -X POST https://api.yourdomain.com/api/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+15551234567",
    "body": "Hello from the API!"
  }'

​
Step 3: Check the response

A successful response will look like this: 
{
  "sid": "SMxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "status": "queued"
}
The sid is a unique identifier for your message, and the status indicates the message has been queued for delivery.

​
What’s next?

Send MMS messages

Learn how to send multimedia messages

Track delivery status

Monitor your message delivery in real-time

Handle errors

Build robust error handling

View API reference

See all available parameters