Skip to content
DialDozer DialDozer Docs

Queue a CTI dial

POST /hooks/api_v1.php?r=cti/dial creates a pending CTI dial for the agent bound to the API key.

Required scope: cti
Additional requirement: the key must have a non-empty agent_user binding

Terminal window
curl --fail-with-body -X POST \
  "https://app.dialdozer.com/hooks/api_v1.php?r=cti/dial" \
  -H "X-Api-Key: $DIALDOZER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+1 (602) 555-0142"}'
{"ok":true,"id":73,"lead_id":48219}

phone is sanitized to digits and must contain at least 10 digits. Matching uses the last 10 digits and newest matching lead. Tenant-bound keys only match within their organization’s campaigns. lead_id can be null; the dial is still queued for a valid number.

An unbound key returns HTTP 403 no_bound_agent. A short/invalid number returns HTTP 422 bad_phone.