Contents ▼

Integrating Speedway with Webhooks

Webhooks are a flexible way to integrate Speedway with all kinds of applications and external systems. Basically, you can provide Speedway with a URL of your choosing, and Speedway will send an HTTP POST to it when something important happens.

Enabling Webhooks

In your Speedway account, go to your Integrations page. Click the Enable Webhook button in the Webhook section.

You'll be prompted for two URLs: a Monitor Fails Webhook URL to hit whenever a monitor fails, and a Monitor Recovers Webhook URL to hit when it recovers. You can enter the same URL in both of these, or different URLs. It's up to you. If you only care about failures and not recoveries, simply leave the recovery URL blank.

Save the webhook settings. Speedway will begin sending an HTTP POST request to these URLs whenever a monitor fails or recovers, including details of the failure or recovery in the body.

Testing Webhooks

Now that the integration is enabled, each time one of your Speedway monitors fails for the first time or after it was previously passing, Speedway will POST to the Monitor Fails Webhook URL. This usually happens within seconds but if the request fails for whatever reason, Speedway will retry it periodically until it succeeds. Your webhook endpoint must respond with an HTTP 2xx status to be considered a success.

You can test this by creating a Speedway monitor that points to an invalid location, submits invalid data, or is otherwise broken.

When the same Speedway monitor recovers, the incident will be resolved in Webhook.

Getting Help

We're happy to assist you if you have any trouble integrating with webhooks. Get in touch at help@speedway.app if there's any way we can help!