- Start here
- Getting Started
- Development Store
- Build an app
-
App Development
-
Webhooks
- Guides by use case
- Popular APIs
-
Logistic Apps
- Reference
- Authentication
- API access scopes
- API call limit
- Response status codes
- API 3.0 reference ↗
- API 4.0 reference ↗
- EasyStore App Store ↗
Webhook Limitations
Keep these limitations in mind when you design your app:
- Delivery isn't guaranteed. Run a reconciliation job (periodic polling) that fetches recent changes from the API, so your app doesn't rely on webhooks alone.
- Delivery can be delayed, especially when there's a surge of traffic.
- Webhooks can arrive out of order or more than once. There's no event ID, so compare timestamps
such as
updated_atbefore overwriting newer data. - Failed deliveries are retried for up to 2 days. After that, the event is dropped.
- Only
200 OKcounts as success. Redirects and other 2xx codes are treated as failures.
See Respond and retries for details.