When this fits
Use Nango for external webhooks when:- A provider can notify you about changes faster than polling alone.
- You need to map incoming provider webhooks to Nango connections.
- Webhooks should trigger follow-up API requests with the userβs credentials.
- You want webhook events and related API calls visible in Nango logs.
- You need real-time sync behavior without relying only on provider webhooks.
How Nango fits in
- You register the Nango webhook URL in the providerβs developer portal.
- The provider sends events to Nango.
- Nango attributes each event to the right integration and connection when possible.
- Nango forwards the event to your app or routes it into a function.
- If the event updates synced data, the function writes records to Nangoβs cache.
Common patterns
- Forward the provider webhook payload to your app for custom handling.
- Use a webhook function to fetch the changed object and update the records cache.
- Keep a periodic sync function as reconciliation in case provider webhooks are missed.
- Register per-connection provider webhooks in an event function after authorization.
What to read next
- Webhook functions - set up provider webhooks and process them in functions.
- Webhook forwarding - forward external API webhooks through Nango to your app.
- Real-time syncs - combine provider webhooks with sync functions.
- Event functions - register provider webhooks after connection creation.
- Receive webhooks from Nango - configure your appβs webhook URL and verify signatures.
- Sync functions - write changed records into Nangoβs cache.