Skip to main content
Webhooks let you send real-time information from your application, database, or static site in Sevalla to another application whenever a specific event occurs. Unlike APIs, which require periodic requests to fetch data (also known as polling), webhooks automatically push data to the URL you specify. When you create a webhook in Sevalla, we send requests to the configured endpoint for the events you select. Each request includes an svl-signature header containing the webhook’s secret. Secrets can be rotated within the webhook, and you can keep the old secret active to ensure a smooth, zero-downtime key rotation. If a delivery fails, Sevalla automatically retries up to 12 times with progressively increasing intervals: 1 minute, 5 minutes, 10 minutes, 30 minutes, 1 hour, 2 hours, 4 hours, 8 hours, 16 hours, 1 day, 2 days, and 3 days. For monitoring and debugging, you can view event delivery and response time charts for each webhook. Additionally, the Event Deliveries section allows you to inspect individual attempts, including full request and response details.

​
Example application

The Sevalla Discord webhook example listens for events sent by Sevalla (such as APP_DEPLOY or STATIC_SITE_UPDATE) and forwards them as notifications to a Discord channel using your Discord Webhook URL. To use this example repository:
  1. Fork the repository on GitHub.
  2. Add an application with the repository in Sevalla.
  3. Create a Discord webhook.
  4. Create a webhook in Sevalla for the APP_DEPLOY event, using a dummy webhook URL to obtain the webhook secret.
  5. Add the following environment variables 
    SEVALLA_WEBHOOK_SECRET=<your webhook secret>
DISCORD_WEBHOOK_URL=<your Discord webhook URL>
  6. Deploy the application. Once deployed, click View and copy the URL.
  7. Update the webhook endpoint with the URL from the deployed application in the format: https://your-app.sevalla.app/webhook
The webhook will now send notifications to your Discord channel whenever an application is deployed within your Sevalla company.

​
Create a webhook

To create a webhook in Sevalla, go to Settings > Webhooks > Create webhook.
Create a new webhook in Sevalla

Create a new webhook in Sevalla.

Complete the details as follows:
  • Endpoint: Enter the URL you want to send the requests to.
  • Description: Add a description for the webhook.
  • Allowed events: You can select all events or choose the events you want to send requests for from the following:
    • APP_CREATE
    • APP_UPDATE
    • APP_DELETE
    • APP_DEPLOY
    • DATABASE_CREATE
    • DATABASE_UPDATE
    • DATABASE_DELETE
    • STATIC_SITE_CREATE
    • STATIC_SITE_UPDATE
    • STATIC_SITE_DELETE
    • STATIC_SITE_DEPLOY
Click Create webhook.
Add the webhook details

Add the webhook details.

Once the webhook is set up, you can view and update its details, monitor event deliveries and response time charts, and inspect each delivery attempt under the Event Deliveries section, including full request and response details.
View and update the webhook

View and update the webhook.

​
Roll the webhook secret

To rotate your webhook secret, select the webhook and click Roll secret.
Roll the secret for the webhook

Roll the secret for the webhook.

Choose when you want the old secret to expire and click Continue.
Select the expiration time for the old secret

Select the expiration time for the old secret.

​
Update the webhook

To change the endpoint, description, or allowed events for the webhook, click Update.
Update the webhook details

Update the webhook details.

Change the required information, and then click Update webhook.

​
Event deliveries

You can inspect each request attempt within Event deliveries. This shows you the individual attempt details, the request that was made, and the response details.
Webhook event deliveries

Webhook event deliveries.

​
Disable a webhook

To disable a webhook, within the webhook Danger zone, click Disable webhook and then click Continue. This stops the webhook from sending events to the endpoint. You can re-enable the webhook to start sending events again at any time.
Disable the webhook

Disable the webhook.

​
Delete a webhook

To delete a webhook, within the webhook Danger zone, click Delete webhook and then click Continue. This completely removes the webhook and its data. This action cannot be undone, and the data cannot be retrieved once it has been deleted.
Delete the webhook

Delete the webhook.