Webhooks

Set webhook_url on a task to have outcomes pushed to you.

Payload

POST {webhook_url}
Content-Type: application/json
User-Agent: RingAHuman-Webhook/1

{
  "event": "task.completed",
  "task": {
    "id": "task_9f2c1a…",
    "status": "completed",
    "external_ref": "crm_88213",
    "outcome": {
      "disposition": "booked",
      "notes": "Spoke with Maria (office manager). Dr. Patel wants the report first.",
      "meeting_at": "Thu Oct 9, 2:00pm CT",
      "completed_at": "2026-10-06T15:11:43.000Z"
    }
  }
}

Delivery

Respond with any 2xx. Delivery is attempted once today and the result is recorded in the task's audit trail. For anything critical, also poll GET /api/tasks/{id}.

Tips

• Use external_ref to match the task to your CRM record.
• Make your handler idempotent, keyed on task.id.