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.
Update a conversation
Updates an existing conversation's fields and returns the updated conversation. Use this endpoint to update a conversation through the Samva email API.
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.