Webhooks

Webhook Events

View as Markdown

SimZ can send webhook events to your application when a call completes or when a call audit finishes. Use these events to sync call outcomes, recording metadata, lead custom data, and audit results.

Event types

EventWhen it firesBest forRequires review prompt?
call.completedAfter recording completes and the call record is updated.Call metadata, recording metadata, lead custom data.No
call.audit.completedAfter audit/review processing finishes.Qualification and review outcomes.Yes

call.completed

This event fires after SimZ stores call recording and metadata. It is independent from audit processing.

1{
2  "event": "call.completed",
3  "callId": "call_1777920072301_12514",
4  "agentId": "d5c58cfd-ddb4-47ba-8c85-d68a8f7f36e3",
5  "companyId": "comp_0005",
6  "status": "Completed",
7  "timestamp": "2026-05-19T15:02:14.781Z",
8  "call": {
9    "direction": "Outbound",
10    "callerNumber": "+15551234567",
11    "toNumber": "+15557654321",
12    "callDateTime": "2026-05-19T15:00:02.000Z",
13    "durationSeconds": 132,
14    "billedDurationMinutes": 3,
15    "recordingUrl": "call_1777920072301_12514.mp3",
16    "twilioCallSid": "CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
17  },
18  "lead": {
19    "customData": {
20      "leadId": "LEAD-001",
21      "campaignTag": "spring-2026"
22    }
23  }
24}

call.audit.completed

This event fires after SimZ finishes review/audit processing. The audit object depends on your agent review prompt and custom fields schema.

1{
2  "event": "call.audit.completed",
3  "callId": "call_1777920072301_12514",
4  "agentId": "d5c58cfd-ddb4-47ba-8c85-d68a8f7f36e3",
5  "companyId": "comp_0005",
6  "status": "successful",
7  "timestamp": "2026-05-19T15:06:41.220Z",
8  "lead": {
9    "customData": {
10      "leadId": "LEAD-001",
11      "campaignTag": "spring-2026"
12    }
13  },
14  "audit": {
15    "qualified": true,
16    "reason": "Customer confirmed interest and scheduled a callback"
17  }
18}

Common fields

FieldTypeDescription
eventstringEvent name.
callIdstringSimZ internal call ID.
agentIdstringAgent that handled the call.
companyIdstringCompany ID.
statusstringCall lifecycle status or audit classification, depending on event.
timestampstringISO 8601 generation timestamp.
lead.customDataobject or nullClient custom data passed with the lead or call.

Delivery behavior

Webhook deliveries are signed when a secret is configured, retried according to webhook settings, and logged in the SimZ webhook management UI.