KOMMIFY API REFERENCE

Build communication into your applications.

Use Kommify unified REST APIs to connect messaging, voice, AI agents, automation, and customer communication with your software architecture.

Get Started with Quickstart View Developer SDKs

BASE

Production API Hosthttps://api.kommify.com/v1

TLS 1.3 • Bearer AuthAuth Specs →

POST/v1/messages

Send a Message

Dispatches a single transactional or campaign message across WhatsApp, SMS, or Google RCS with automatic fallback handling.

Authentication

Bearer Token (API Key)

Headers

Key	Value / Description
Authorization	Bearer km_live_...Your secret enterprise API key.
Content-Type	application/jsonRequest payload MIME type.
Idempotency-Key	uuid-v4-optionalOptional unique key to prevent duplicate message dispatch.

Body Parameters

Field	Type	Description
channel*	string	Target channel: "whatsapp" \| "sms" \| "rcs" \| "auto"
recipient*	string	E.164 formatted international phone number.
content	object	Direct message payload or text body.
template	object	Pre-registered template identifier and dynamic parameter list.
callback_url	string	Custom webhook URL to receive delivery receipt events for this message.

Code Example

curl -X POST https://api.kommify.com/v1/messages \
  -H "Authorization: Bearer km_live_9f8a3c8e21a7" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "whatsapp",
    "recipient": "+919876543210",
    "template": {
      "name": "order_confirmation_v2",
      "language": "en",
      "parameters": [
        { "type": "text", "text": "Priya Sharma" },
        { "type": "text", "text": "ORD-94821" },
        { "type": "text", "text": "Rs. 1,840" }
      ]
    }
  }'

Response202 OK

{
  "id": "msg_901a8b2c4e5f6g7h",
  "status": "queued",
  "channel": "whatsapp",
  "recipient": "+919876543210",
  "created_at": "2026-09-23T08:00:00Z",
  "estimated_delivery": "sub-second",
  "cost_units": 1
}

GET/v1/messages/{message_id}

Get Message Status & Telemetry

Retrieves the real-time status, carrier delivery timestamp, and read receipt for a dispatched message.

Authentication

Bearer Token (API Key)

Headers

Key	Value / Description
Authorization	Bearer km_live_...Your secret enterprise API key.

Code Example

curl -X GET https://api.kommify.com/v1/messages/msg_901a8b2c4e5f6g7h \
  -H "Authorization: Bearer km_live_9f8a3c8e21a7"

Response200 OK

{
  "id": "msg_901a8b2c4e5f6g7h",
  "status": "delivered",
  "channel": "whatsapp",
  "recipient": "+919876543210",
  "carrier_status_code": "200_OK",
  "sent_at": "2026-09-23T08:00:01Z",
  "delivered_at": "2026-09-23T08:00:02Z",
  "read_at": "2026-09-23T08:00:45Z"
}

POST/v1/voice/calls

Initiate Programmable Outbound Call

Initiates an outbound automated voice call or connects an AI Voice Agent to a recipient with dynamic IVR call flows.

Authentication

Bearer Token (API Key)

Headers

Key	Value / Description
Authorization	Bearer km_live_...Your secret enterprise API key.
Content-Type	application/jsonRequest payload MIME type.

Body Parameters

Field	Type	Description
to*	string	Destination phone number in E.164 format.
from*	string	Caller ID / Virtual Number provisioned on your account.
agent_id	string	AI Voice Agent identifier for automated conversational dialog.
record	boolean	Whether to record call audio for compliance and quality QA.

Code Example

curl -X POST https://api.kommify.com/v1/voice/calls \
  -H "Authorization: Bearer km_live_9f8a3c8e21a7" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919876543210",
    "from": "+918045678900",
    "agent_id": "agent_lead_qualifier_01"
  }'

Response201 OK

{
  "call_id": "call_7719a0bc4123",
  "status": "ringing",
  "to": "+919876543210",
  "from": "+918045678900",
  "agent_id": "agent_lead_qualifier_01",
  "created_at": "2026-09-23T08:05:00Z"
}

OFFICIAL CLIENT LIBRARIES

Prefer SDKs over raw HTTP requests?

We provide official libraries for Node.js/TypeScript, Python, PHP, and Postman collections with type safety and automatic retries.

Explore Developer Tools & SDKs

Client Trust & Partnership

Trusted by Businesses Across Industries

Powering communication, engagement and growth for organizations across industries.

BayerEnterprise

Little EllyEducation

LETTERTechnology

EliteHospitality

GlentreeEducation

Elly Child CareEarly Learning

AMCHealthcare

PIMSMedical Sciences

DBITInstitutions

JAS DentalHealthcare

Dr Rao Dental CentralDental Care

Pearl HotelsHospitality

HeartfulnessGlobal Wellness

DentrayHealthcare Tech

BayerEnterprise

Little EllyEducation

LETTERTechnology

EliteHospitality

GlentreeEducation

Elly Child CareEarly Learning

AMCHealthcare

PIMSMedical Sciences

DBITInstitutions

JAS DentalHealthcare

Dr Rao Dental CentralDental Care

Pearl HotelsHospitality

HeartfulnessGlobal Wellness

DentrayHealthcare Tech

BayerEnterprise

Little EllyEducation

LETTERTechnology

EliteHospitality

GlentreeEducation

Elly Child CareEarly Learning

AMCHealthcare

PIMSMedical Sciences

DBITInstitutions

JAS DentalHealthcare

Dr Rao Dental CentralDental Care

Pearl HotelsHospitality

HeartfulnessGlobal Wellness

DentrayHealthcare Tech