curl -X POST 'https://backend.blooio.com/v1/api/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "to": "+15551234567",
    "text": "Hello from Blooio!"
  }'
1

Get your API key

Sign in to your Blooio account and create an API key.
Keep your API key secret. Never commit it to source control.
2

Set your environment variable

Store your API key in an environment variable for local testing.
export BLOOIO_API_KEY=YOUR_API_KEY
3

Send your first message

Use the Messages endpoint to queue a message.
curl -X POST 'https://backend.blooio.com/v1/api/messages' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "to": "+15551234567",
    "text": "Hello from Blooio!"
  }'
Response includes message_id and status queued.
4

Receive webhook events

Configure your webhook URL to receive delivery updates and inbound messages.
curl -X PUT 'https://backend.blooio.com/v1/api/config/webhook' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "webhook_url": "https://example.com/mywebhook" }'
See all webhook payloads in Webhook events. For local testing, use a tunneling tool and see Receive webhooks locally.
5

Track message status

Poll for status or retrieve full details.
curl -H 'Authorization: Bearer YOUR_API_KEY' \
  'https://backend.blooio.com/v1/api/messages/{messageId}/status'

​
Next steps

Authentication

Learn how to pass your Bearer token.

Idempotency

Ensure safe retries using Idempotency-Key.

Receive webhooks locally

Test webhooks with a local server.

Send attachments

Include media URLs in outbound messages.