Webhooks
Subscribe to delivery and inbound events with signed, verifiable webhook payloads.
webhooks push delivery and inbound events to your endpoints in real time, so you
don't have to poll messages. Every payload is signed;
verify the signature before trusting it.
What you can do
- Manage endpoints, create, retrieve, list, update, and remove.
- Secrets, regenerate an endpoint's signing secret.
- Observability, inspect delivery logs and stats.
- Reliability, send a test event and retry a failed delivery.
Verifying payloads
Webhook requests are signed with your endpoint's secret. Verify the signature on every request and reject anything that doesn't match, see Webhooks for the signing scheme and a verification example.
Shared conventions (auth, status codes, errors, pagination) are in the REST API reference. Per-operation request and response detail is in the sidebar.
Related documentation
Upgrade or roll back an installation
Changes the pinned version in place. Omit version for the latest publication, or name a version string or id, including an older version to roll back.
Create a webhook
Creates a signed webhook endpoint for Samva delivery and inbound events, stores subscriptions, and returns the endpoint and signing secret with a 201 response.