Learn how to create and configure webhooks to integrate your rotations with external tools and automate workflows.

Webhooks allow you to integrate Rotation App with your other tools by automatically triggering actions when rotation events occur.

Common use cases include:

• Syncing the on-call user with incident management platforms like PagerDuty or Incident.io
• Updating task management tools like Linear or Jira
• Notifying monitoring services like BetterStack
• Triggering custom workflows in your own systems

For example, when the on-call user changes in Rotation App, a webhook can automatically update the corresponding on-call schedule in PagerDuty to keep both systems in sync.

How to create a rotation webhook?

1. Go to Rotation App’s Home tab
   Learn where to find Rotation App’s Home tab.
2. Find the rotation you want to add a webhook to
3. Open the Rotation Webhooks dialog
   Open the rotation menu and select 🪝 Webhooks.
   This will open the Rotation Webhooks dialog where you can view, edit, and manage all webhooks configured for this rotation.
4. Open the Add Webhook dialog
   Select the ➕ New Webhook button to start adding a new webhook.
5. Fill in the webhook details
   1. Give your webhook a name: This will help you identify the webhook in the list of webhooks.
   2. Insert the webhook URL: The endpoint to call when the webhook is triggered.
   3. Select the webhook events: Choose the events that will trigger the webhook. Learn more about the webhook events in the Rotation Webhook events article.
   4. Add a request header (optional): Select Add header to send a header, like an API key, with every request. Learn more in Secure your webhook with a request header.
6. Submit the form
   Select the Add button to add the webhook.

Secure your webhook with a request header

Anyone who knows your webhook URL can send requests to it. To make sure a request really comes from Rotation App, you can have the webhook send a header with a secret value, and set your endpoint to reject requests without it. Each webhook can send one header.

1. Open the Add Webhook or Edit Webhook dialog
2. Select Add header in the Request Header section
3. Fill in the header
   1. Header Name: The name your endpoint expects, for example Authorization or X-Api-Key.
   2. Header Value: The secret value, for example Bearer my-secret-token. When editing a webhook that already has a header, leave this field empty to keep the saved value, or type a new one to replace it.
4. Save the webhook

Rotation App sends the header with every event, and with test events from the 🧪 Test option. If your endpoint is an automation platform or an API gateway, set it to require the same header name and value.

To stop sending the header, open the Edit Webhook dialog, select Remove header, and save the webhook.

Learn more about the webhook events in the Rotation Webhook events article.