Products
WhatsApp Business APIWhatsApp chatbotWhatsApp marketingTeam inboxAI StudioSMS gatewayCloud call centerCompany
IndustriesDevelopersPricingWhatsApp API guideWhatsApp API by countryCompare UnecastPartnersAboutContactLog inDevelopers
APIs for WhatsApp, SMS and AI agents.
Send and receive WhatsApp messages, manage contacts and webhooks, send SMS over REST or SMPP, and run your AI agents from any system.
# Send an approved WhatsApp template curl -X POST https://platform.unecast.com/api/v1/messages/template \ -H "X-API-Key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "to": "94771234567", "templateName": "order_shipment_update", "language": "en", "components": [{ "type": "body", "parameters": [{ "type": "text", "text": "Maya" }] }] }'
# Send a transactional SMS curl -X POST https://api.unecast.com/v2/send \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "channel": "sms", "from": "YOURBRAND", "to": "94771234567", "message": "Your OTP is 482913", "priority": "high" }'
# Run an AI agent you built in AI Studio curl -X POST https://aistudio.unecast.com/agents/YOUR_AGENT_ID/runs \ -H "Authorization: Bearer YOUR_TENANT_KEY" \ -H "Content-Type: application/json" \ -d '{ "message": "Do you deliver to Kandy?" }'
WhatsApp API
Base URL https://platform.unecast.com. Authenticate every request with your key in the X-API-Key header. Create keys in Settings, API key setting.
| Method | Path | What it does |
|---|---|---|
| POST | /api/v1/messages/template | Send an approved template message to a contact |
| POST | /api/v1/messages/reply | Send a free-text reply inside the 24-hour service window |
| GET | /api/v1/messages/:contactPhone | Get the message history for a contact |
| GET | /api/v1/messages/status/:messageId | Get the delivery status of a message |
| GET | /api/v1/contacts | List contacts |
| POST | /api/v1/contacts | Create a contact |
| PUT | /api/v1/contacts/:id | Update a contact |
| DELETE | /api/v1/contacts/:id | Delete a contact |
| GET | /api/v1/contacts/groups | List contact groups |
| POST | /api/v1/contacts/groups/:groupId/add | Add contacts to a group |
| POST | /api/v1/contacts/groups/:groupId/remove | Remove contacts from a group |
| GET | /api/v1/templates | List message templates |
| GET | /api/v1/campaigns | List campaigns |
| GET | /api/v1/account | Get account details |
| GET | /api/v1/account/usage | Get account usage |
| GET | /api/v1/webhooks | List webhooks |
| POST | /api/v1/webhooks | Create a webhook |
| PUT | /api/v1/webhooks/:id | Update a webhook |
| DELETE | /api/v1/webhooks/:id | Delete a webhook |
Webhooks deliver incoming messages and status changes to your server. Full request and response examples are in API docs inside your Unecast workspace.
SMS API
All SMS calls use a Bearer token in the Authorization header. SMPP is available for high-volume systems.
| Method | Path | What it does |
|---|---|---|
| POST | https://api.unecast.com/v2/send | Send a message with channel, from, to, message and priority |
| GET | https://api.unecast.com/v2/account/balance | Read your account balance |
| GET | https://api.unecast.com/v2/status/{message_id} | Read the delivery status of one message |
# Send a transactional SMS curl -X POST https://api.unecast.com/v2/send \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "channel": "sms", "from": "YOURBRAND", "to": "94771234567", "message": "Your OTP is 482913", "priority": "high" }'
AI agent API
Every agent, team or workflow you build in AI Studio has its own run endpoint.
- Run an agent with POST /agents/{agent-id}/runs on aistudio.unecast.com.
- Authenticate with a tenant-scoped key as a Bearer token. The secret is shown once.
- Lock it down with an expiry and allowed IP addresses or CIDR ranges.
- Shape the response with response filters, validators and session state.
# Run an AI agent you built in AI Studio curl -X POST https://aistudio.unecast.com/agents/YOUR_AGENT_ID/runs \ -H "Authorization: Bearer YOUR_TENANT_KEY" \ -H "Content-Type: application/json" \ -d '{ "message": "Do you deliver to Kandy?" }'
Connect the tools you already use.
Online stores
WooCommerce and Shopify for order and delivery updates.
Websites
WordPress and the Unecast website chat widget.
Automation
Microsoft Power Platform, webhooks and MCP servers.
Billing and hosting
WHMCS for invoices and service notifications.
Need help scoping an integration?
Our engineers will review your systems and suggest the simplest way to connect. Call +94 77 600 3273 or write to sales@unecast.com.