Download OpenAPI specification:Download
API for managing Svix webhook integrations
Retrieve a list of all Svix integration records with optional filtering and pagination
| limit | integer [ 1 .. 100 ] Default: 50 Maximum number of records to return |
| offset | integer >= 0 Default: 0 Number of records to skip for pagination |
| sort | string Field to sort by |
| order | string Default: "desc" Enum: "asc" "desc" Sort order (asc or desc) |
| filter | string Filter conditions in JSON format |
| search | string Search term for text fields |
{- "success": true,
- "data": [
- {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "name": "Webhook Integration",
- "description": "string",
- "applicationId": "app_12345",
- "eventTypes": [
- "user.created",
- "order.updated"
], - "secret": "string",
- "isActive": true,
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
], - "total": 0
}Create a new Svix integration with the provided data
| name required | string Name of the integration |
| description | string Description of the integration |
| applicationId required | string Svix application ID |
| endpointUrl required | string <uri> Webhook endpoint URL |
| eventTypes | Array of strings List of event types to subscribe to |
| secret | string Webhook secret for signature verification |
| isActive | boolean Default: true Whether the integration is active |
object Additional metadata |
{- "name": "Webhook Integration",
- "description": "string",
- "applicationId": "app_12345",
- "eventTypes": [
- "user.created",
- "order.updated"
], - "secret": "string",
- "isActive": true,
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "name": "Webhook Integration",
- "description": "string",
- "applicationId": "app_12345",
- "eventTypes": [
- "user.created",
- "order.updated"
], - "secret": "string",
- "isActive": true,
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Retrieve a specific Svix integration by its ID
| id required | string Svix integration ID |
{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "name": "Webhook Integration",
- "description": "string",
- "applicationId": "app_12345",
- "eventTypes": [
- "user.created",
- "order.updated"
], - "secret": "string",
- "isActive": true,
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}Update an existing Svix integration with new data
| id required | string Svix integration ID |
| name required | string Name of the integration |
| description | string Description of the integration |
| applicationId required | string Svix application ID |
| endpointUrl required | string <uri> Webhook endpoint URL |
| eventTypes | Array of strings List of event types to subscribe to |
| secret | string Webhook secret for signature verification |
| isActive | boolean Default: true Whether the integration is active |
object Additional metadata |
{- "name": "Webhook Integration",
- "description": "string",
- "applicationId": "app_12345",
- "eventTypes": [
- "user.created",
- "order.updated"
], - "secret": "string",
- "isActive": true,
- "metadata": { }
}{- "success": true,
- "data": {
- "_id": "60f7b1b3e4b0e8b3f8b3f8b3",
- "name": "Webhook Integration",
- "description": "string",
- "applicationId": "app_12345",
- "eventTypes": [
- "user.created",
- "order.updated"
], - "secret": "string",
- "isActive": true,
- "metadata": { },
- "createdAt": "2023-01-15T08:00:00Z",
- "updatedAt": "2023-01-15T10:30:00Z"
}
}