Webhook endpoints
Webhook endpoints are HTTPS URLs owned by your COPE business. Register endpoints in the COPE dashboard and subscribe each endpoint to the event types your integration is ready to process.Endpoint requirements
An endpoint’s signing secret is returned only when the endpoint is created and when its secret is rotated, and only in the first response: a retry with the same
Idempotency-Key returns the 201 again without signing_secret. Store it securely and verify every delivery before parsing the event payload. See Rotating the signing secret.
Source IP addresses
If your firewall accepts traffic only from known addresses, allow these. In production, COPE sends every webhook delivery from one of them: events, automatic retries, test events and replays.- They cover webhook deliveries only. Emails COPE sends do not come from them.
- They can change. A change is listed in the changelog.
- An allowlist does not replace signature verification: verify every delivery as described in Webhook signing.