Getting Started
Quick Start Guide
Get up and running with SendComms in under 5 minutes. Choose a service below to see examples.
Select Service
1
Get Your API Key
Sign up or log in to your dashboard to get your API key. You can create either:
🧪
sc_test_Test key for sandbox mode - no charges
🚀
sc_live_Live key for production - real messages
2
Send Your First Email 📧
Request
curl -X POST https://api.sendcomms.com/api/v1/email/send \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "you@yourdomain.com",
"to": "customer@example.com",
"subject": "Welcome to our platform!",
"html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>"
}'3
Handle the Response
A successful request returns a JSON response with the status and details:
Response200 OK
{
"success": true,
"data": {
"transaction_id": "email_mjhw7md7_a8a05860a95c",
"email_id": "8f1c2d4e-9b3a-4a77-bd10-2f6c5e91a3d7",
"status": "sent",
"from": "you@yourdomain.com",
"to": ["customer@example.com"],
"subject": "Welcome to our platform!",
"recipients": 1,
"price": { "amount": 0.001, "currency": "USD" },
"created_at": "2026-08-22T09:11:44.007Z"
}
}4
Set Up Webhooks (Optional)
Get real-time notifications for delivery status, bounces, and more by registering a webhook endpoint:
Register Webhook
curl -X POST https://api.sendcomms.com/api/v1/webhooks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://yourapp.com/webhooks/sendcomms",
"events": ["email.sent", "email.delivered", "email.bounced"]
}'