Webhook Retries

There might be times when a notification can’t be delivered to your listener endpoint, for example if your endpoint is offline. If delivery fails, Branch automatically schedules delivery attempts according to a Branch-configured formula.

As currently configured, failures will retry after:
first failure: 30 seconds

  • second failure: 60 seconds
  • third failure: 5 minutes
  • fourth failure: 30 minutes
  • fifth failure and all following failures will repeat after 60 minutes, continuing for 7 days

Idempotency

The webhook that Branch sends you always includes an event_id token that you can use as an idempotency key to deduplicate your received webhooks. This event_id will remain the same in every redelivery attempt of the event. See Example Webhook Request for details about the event_id in the request and response structure.