Kato Scheduled Call Update

post

https://{your-totality-url}.com/webhooks/kato-scheduled-calls

Kato AI Dialer posts this webhook when a scheduled call's lifecycle changes (status, outcome, duration, billed duration, tags). The host application updates its local KatoCallLog row to mirror Kato's state and logs the payload in KatoWebhookLog. Authenticated by the x-api-key header against the kato_webhook_secret value configured in Integration Settings.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

string

required

Kato-assigned UUID for the scheduled call (matches kato_call_logs.kato_call_id).

status

string

required

Current Kato status for the call (e.g. scheduled, in_progress, completed, cancelled, failed).

outcome

string | null

Call outcome supplied by Kato when the call completes (e.g. answered, no_answer, voicemail, payment_authorized).

dialed_at

date-time | null

ISO-8601 timestamp Kato dialed the call. Drives the analytics dashboard's time-of-day and day-of-week breakdowns.

duration

integer | null

Total call duration in seconds.

billed_duration

integer | null

Billable duration in seconds (may differ from duration when Kato applies minimum-billing increments).

tags

Headers

x-api-key

string

required

Webhook secret configured on the Kato integration setting. Requests with a missing or mismatched value receive HTTP 403.

x-webhook-event

string

Kato event identifier (e.g. call.scheduled, call.dialed, call.completed, call.cancelled). Persisted on KatoWebhookLog for audit.

Responses

204

Update accepted and applied to the matching KatoCallLog.

403

Missing or invalid x-api-key header.

404

No KatoCallLog matches the supplied id; Kato should not retry.

422

Request body failed validation (e.g. id or status missing).

Language

Credentials

URL

Loading…