Quickstart
Create a workspace, generate an API key, then send your first message.
# 1) Create an API key in the dashboard
# 2) Send a message
curl -X POST https://api.svcmsg.com/v1/messages \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"to":"+15551234567","channel":"sms","text":"Your login code is 194203"}'
Authentication
Use a Bearer token. Rotate keys regularly and restrict keys per environment.
Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxx
Send a message
Send raw text or a template with variables.
POST /v1/messages
{
"to": "+15551234567",
"channel": "sms",
"template": "otp_login",
"variables": { "code": "194203" }
}
Webhooks
Receive delivery updates (planned): delivered, failed, queued, provider-retry.
POST /v1/webhooks
{
"url": "https://yourapp.com/svcmsg/webhook",
"events": ["message.delivered","message.failed"]
}
Errors
Errors follow a consistent structure to support reliable retry logic.
{
"error": {
"code": "rate_limited",
"message": "Too many requests",
"retry_after_seconds": 12
}
}