Skip to navigation
Webhooks

Call Events

Receive CALL.STATUS events as voice calls move through their lifecycle.

Subscribe by attaching a webhook to a voice-enabled phone number. CALL.STATUS is only supported for phone number senders, not RCS agent senders.

Before trusting the payload, verify the PINNACLE-SIGNING-SECRET header matches the signing secret of the webhook this event was delivered to. Respond with a 200 to acknowledge receipt — any non-2xx response causes Pinnacle to retry with exponential backoff.

Headers

PINNACLE-SIGNING-SECRETstringRequired

Secret for verifying the authenticity of the request. Starts with pss- and is unique for each webhook. Find it at webhooks.

Payload

The payload of this webhook request is an object.
typeenumRequired
Allowed values:
senderstringRequired

Team-owned phone number that matched the webhook subscription. For inbound calls this is the call.to number; for outbound calls this is the call.from number.

callobjectRequired

Response

200
Return a 200 status to indicate that the data was received successfully