Welcome to the Svix API documentation!
Useful links: Homepage | Support email | Blog | Slack Community
This is the reference documentation and schemas for the Svix webhook service API. For tutorials and other documentation please refer to the documentation.
In Svix you have four important entities you will be interacting with:
Docs
Main site
Need help?
Participate
Resourcesmessages: these are the webhooks being sent. They can have contents and a few other properties.application: this is where messages are sent to. Usually you want to create one application for each user on your platform.endpoint: endpoints are the URLs messages will be sent to. Each application can have multiple endpoints and each message sent to that application will be sent to all of them (unless they are not subscribed to the sent event type).event-type: event types are identifiers denoting the type of the message being sent. Event types are primarily used to decide which events are sent to which endpoint.Get your authentication token (AUTH_TOKEN) from the Svix dashboard and use it as part of the Authorization header as such: Authorization: Bearer ${AUTH_TOKEN}.
The code samples assume you already have the respective libraries installed and you know how to use them. For the latest information on how to do that, please refer to the documentation.
Svix supports idempotency for safely retrying requests without accidentally performing the same operation twice. This is useful when an API call is disrupted in transit and you do not receive a response.
To perform an idempotent request, pass the idempotency key in the Idempotency-Key header to the request. The idempotency key should be a unique value generated by the client. You can create the key in however way you like, though we suggest using UUID v4, or any other string with enough entropy to avoid collisions.
Svix’s idempotency works by saving the resulting status code and body of the first request made for any given idempotency key for any successful request. Subsequent requests with the same key return the same result.
Please note that idempotency is only supported for POST requests.
This API features Cross-Origin Resource Sharing (CORS) implemented in compliance with W3C spec. And that allows cross-domain communication from the browser. All responses have a wildcard same-origin which makes them completely public and accessible to everyone, including any code on any site.
Use this page to mock Svix API in your testing and development.
Run our mock API sample using the open source WireMock library, or in the free edition of WireMock Cloud. You'll have a working API server simulating the behavior of Svix API, which will allow you to keep building and testing even if the actual API you isn't currently available.