Developers
Build on your customer conversations
Send messages, sync contacts, create leads and react to every event - from your shop, CRM or backend.
For developers
Plug it into the rest of your stack
A public REST API and outgoing webhooks let you send messages, sync contacts, create leads and react to events from your own systems.
- Scoped credentialsOAuth client credentials per application, with scopes, rotation and request logs.
- Webhooks with replaySigned outgoing events with delivery logs, and replay for anything you missed.
- Built for retriesIdempotency keys and clear rate limits, so a retried request never sends twice.
curl -X POST https://communication-api.artofluminaire.com/api/v1/messages \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Idempotency-Key: order-58213-confirm" \
-H "Content-Type: application/json" \
-d '{
"channel": "whatsapp",
"to": "+919876543210",
"type": "template",
"external_reference": "order-58213",
"message": {
"template": "order_confirmation",
"language": "en",
"variables": ["Rahul", "58213"]
}
}'REST API v1
Full API referenceThe endpoints you will use
JSON over HTTPS, authenticated with OAuth client credentials. Every application gets its own scopes, rate limits and request log.
- POST
/messagesSend text or an approved template on WhatsApp, email, Telegram, web chat, Instagram or Facebook. - GET
/messages/{id}A message with its delivery timeline - sent, delivered, read or failed. - GET
/conversationsConversations with their status, assignee and channel. - GET
/contactsContacts with their identities, tags and custom fields. - POST
/contactsCreate or update a contact from your CRM, shop or signup form. - GET
/templatesThe approved message templates you can send. - POST
/leadsCreate a lead in a pipeline from your own forms or systems. - POST
/eventsPush an external event that can start an automation workflow.
Webhooks
React the moment something happens
Subscribe an endpoint to the events you care about. Every delivery is signed, logged, retried on failure and can be replayed from the workspace.
- message.received
- message.queued
- message.sent
- message.delivered
- message.read
- message.failed
- conversation.created
- conversation.assigned
- conversation.status_changed
- contact.created
- contact.updated
- lead.created
- lead.stage_changed