Prerequisites
- A Super Admin account in Piper
- An HTTPS endpoint able to receive POST requests
Setting Up a Webhook
1
Add a webhook
Click + Add webhook and give it a Name and a destination URL (must be
https://).2
Choose event types
Select which events should trigger this webhook: AI Transcription & Notes, CRM Fields, or Call Scoring Value. You can select more than one.
3
Add custom headers (optional)
Add any custom headers your endpoint needs, as repeatable key/value pairs.
4
Save and verify
Save the webhook. Piper shows a signing secret you can use to verify each request came from Piper — every delivery is signed (Standard Webhooks/HMAC) and can be rotated at any time from the same screen.
Delivery and Security
- Deliveries only go to HTTPS URLs.
- Every request is signed using the Standard Webhooks/HMAC scheme, so you can verify it originated from Piper.
- Failed deliveries (timeouts or server errors) are automatically retried.
- Rotate the signing secret at any time from the same screen if you suspect it’s been compromised.
Payload Schema
Every delivery is the same JSON envelope, wrapping one of threedata shapes depending on type:
extracts (AI Transcription & Notes):
deal_values (CRM Fields):
call_score (Call Scoring Value):
data object also includes a json_content field: the same payload, base64-encoded, kept for compatibility with older Zapier zaps.
For a different automation platform, or a use case that needs full API access instead of event push, see Zapier or contact support@piperai.com.