Send WhatsApp and email

Templates stay in Omni Channel. The API only lists them and sends.

Dashboard (once)

Omni Channel: verified email mailbox and/or WhatsApp profile + templates.Start an API / Custom CRM campaign. Copy campaignId.

Lead setup - does this campaign’s template exist?

Paste campaignId into Lead setup (Try it).

curl -sS -H "Authorization: Bearer $ONDIAL_API_KEY" \
  "$ONDIAL_BASE_URL/api/v1/campaigns/YOUR_CAMPAIGN_ID/lead-setup"

Read checks: ok: true means that profile/template exists. readyFor.email / readyFor.whatsapp tells you which channels you can send.Copy email.lead or whatsapp.lead. Fill email / phone (and whatsappParams using paramLabels).Optional: Validate lead with that body - nothing is created. ok: true means POST /leads will pass.To browse every template: GET /api/v1/omni/templates (add ?campaignId= to mark selected). Copy email.templates[].lead or whatsapp.templates[].lead.

POST /leads

curl -sS -X POST "$ONDIAL_BASE_URL/api/v1/leads" \
  -H "Authorization: Bearer $ONDIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "YOUR_CAMPAIGN_ID",
    "email": "asha@example.com",
    "name": "Asha",
    "channel": "email",
    "emailTemplateId": "YOUR_EMAIL_TEMPLATE_ID",
    "emailProfileId": "YOUR_EMAIL_PROFILE_ID",
    "templateVariables": {
      "contact_name": "Asha",
      "company_name": "Acme",
      "agent_name": "Roshni"
    }
  }'

templateVariables keys are dynamic: only include keys that appear as {{…}} in your selected template (copy from Lead setup). Not every template has contact_name / company_name / agent_name - if none, send "templateVariables": {}.

Only this	Body
WhatsApp	`"channel": "whatsapp"` + `phone` (no `consent`)
Email	`"channel": "email"` + `email` (no `consent`; `phone` optional, not dialed)
Call	`"channel": "call"` + `phone` + `consent.outboundCall: true` - no first-touch message

Use one channel per request.WhatsApp example (fill whatsappParams in the same order as Lead setup paramLabels - [0] → {{1}}, [1] → {{2}}, …):

curl -sS -X POST "$ONDIAL_BASE_URL/api/v1/leads" \
  -H "Authorization: Bearer $ONDIAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "campaignId": "YOUR_CAMPAIGN_ID",
    "phone": "+919876543210",
    "name": "Asha",
    "channel": "whatsapp",
    "whatsappProfileId": "YOUR_WHATSAPP_PROFILE_ID",
    "whatsappTemplateId": "YOUR_WHATSAPP_TEMPLATE_ID",
    "whatsappParams": [
      "Asha",
      "CRM-99",
      "Home loan",
      "₹5000",
      "30 Sep 2026",
      "https://track.example/abc"
    ]
  }'

Index	Placeholder	Example value
`[0]`	`{{1}}`	Name → `Asha`
`[1]`	`{{2}}`	Order ID → `CRM-99`
`[2]`	`{{3}}`	Product → `Home loan`
…	…	Match your template’s `paramLabels`

Passing a wrong emailTemplateId / whatsappTemplateId returns 422 (*_not_found) instead of silently using another template.

Check status

201 repeats the template ids. Poll GET /api/v1/contacts/{contactId} for whatsappQueueStatus / emailStatus.Sandbox keys accept but never send.

Omit clocks to send as soon as Calling_system1 picks up the queue. Required on email: emailProfileId, emailTemplateId, templateVariables (object - keys = your template’s {{placeholders}} only; use {} if none). Required on WhatsApp: whatsappProfileId, whatsappTemplateId, whatsappParams. Get ids and exact keys/params from Lead setup.

Get started

Send leads (outbound)

Answer calls (inbound)

Integrations

Concepts

Go live

Send WhatsApp and email