Messages

Send a message

POST /hooks/api_v1.php?r=messages

Requires messages:write.

curl -X POST 'https://app.dialdozer.com/hooks/api_v1.php?r=messages' \
  -H "X-Api-Key: $DIALDOZER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "lead_id": 42,
    "channel": "sms",
    "body": "Your appointment is confirmed.",
    "operation_id": "appt-42-confirmed-v1"
  }'

Body

Field	Type	Required	Description
lead_id	integer	yes	Existing lead identifier
channel	sms, email, note	yes	Delivery channel
body	string	yes	Message body
subject	string	email only	Email subject
operation_id	string	recommended	Idempotency key for safe retries

The API surfaces the communication service’s complete send result, including message_id, gating reason, or defer_until when applicable.

Billing failures return HTTP 402 with one of: billing_not_configured, billing_unavailable, billing_frozen, subscription_required, or insufficient_credits.