When building Flip integrations, you might want your applications to receive events as they occur in order to avoid polling Flip's endpoints, so that your backend systems can execute actions in real time.To enable webhook events, you need to create a webhook endpoint in your system, and provide us with the URL. Flip uses HTTPS with the POST method to send webhook events to your app.Flip expects all webhooks to be acknowledged with a 200 or 204 HTTP code. If a successful response is not received, our system will attempt four re-deliveries.The default timeout period is 5 seconds.Webhooks will contain a JSON body, as documented here:Object schema depends on event type
Best practices#
Webhook endpoints might occasionally receive the same event more than once. You can guard against duplicated event receipts by making your event processing idempotent. One way of doing this is logging the events you’ve processed, and then not processing already-logged events.Handle events asynchrounouslyConfigure your handler to process incoming events with an asynchronous queue. You might encounter scalability issues if you choose to process events synchronously. Any large spike in webhook deliveries (for example, when a utility creates an event) might overwhelm your endpoint hosts.Asynchronous queues allow you to process the concurrent events at a rate your system can support. Modified at 2025-04-22 14:34:06
