data is the only part that changes. For delivery, signing, and retry behavior, read the webhooks overview.
The envelope
string
required
Always
upliftai.call.v1 today.enum<string>
required
One of
call.completed, call.graded, conversion.created, callback.opened.string
required
callId#eventType — your idempotency key. A retry can deliver the same event twice, so process once per eventId.string
required
The assistant that took or made the call.
integer
The version number the call ran. Present when known. Calls from before versions have no key.
enum<string>
prod or draft, when the call was launched by alias. Absent when you launched an exact version number.string
Campaign calls only. On inbound, web, and direct API calls the key is absent, not null.
string<date-time>
required
ISO-8601, stamped when the post-call analysis ran — not when the call ended. For call timings, read the session’s timestamps.
object
required
Per event, below.
callId and sessionId inside it are the same string today: the id every session endpoint takes. On a campaign call that id uses the campaign’s own session id format.call.completed
Every call fires it once its post-call analysis runs — including dials that never connected. Check the session’sstate and failureReason before treating it as a conversation.
string
required
The session id.
string
required
Same string as
callId today.campaignId included:
call.graded
Fires when a connected call is graded against a scorecard. No scorecard, no event.string
required
The session id.
integer | null
required
The score, 0 to 100, out of the points that applied to this call.
null when every criterion was N/A. The event still fires, so handle null before you compare. The per-criterion breakdown is not in the event — read it on the session detail.conversion.created
Fires the first time a conversion is recorded for the call. Reprocessing never fires it twice. The conversion body itself is not in the event — fetch it from the session detail.string
required
The session id.
callback.opened
Fires when the call opens a callback — the customer asked to be called again, or the assistant scheduled a follow-up.string
required
The session id.