Retry policy

Introduction

Webhooks are HTTP callbacks that are triggered when an event occurs on featureOS. When a webhook is triggered, we will send a POST request to the webhook's configured URL. If the request fails, we will retry the request according to the webhook's retry policy.

Retry policy

The retry policy determines the number of times we retry a request and how long we will wait between retries.

When a request fails (i.e., we do not receive a 200 from your endpoint), we will retry the request three times at a retry interval of 5 minutes, 30 minutes, and 2 hours. If the request fails all three times, we will stop retrying and disable the webhook.

Consequently you will be notified via an email. In that event, you can navigate to your featureOS Dashboard → Organization Settings → Webhooks to reenable it after fixing your endpoint.

Retry intervals

The retry intervals are the amount of time we will wait between retries. The retry intervals are configured when you create a webhook. The retry intervals are 1 minute, 5 minutes, and 1 hour by default.

When a request fails, we will wait the amount of time specified by the first retry interval before retrying the request. If the request fails again, we will wait the amount of time specified by the second retry interval before retrying the request. If the request fails again, we will wait the amount of time specified by the third retry interval before retrying the request.

Retry logs

You can view the retry logs for a webhook by clicking the webhook's name on the webhooks area. The retry logs will show the status of each request attempt.