Process external webhooks

Many APIs can notify you when something changes, but each provider has its own webhook registration flow, payload shape, retries, and connection mapping. Tenklo gives external APIs one integration-specific webhook URL and attributes incoming events to the right connection.

You can forward those webhooks to your app, process them in Tenklo functions, or combine them with sync functions for reliable near real-time data.

When this fitsCopy Anchor Link

Use Tenklo for external webhooks when:

• A provider can notify you about changes faster than polling alone.
• You need to map incoming provider webhooks to Tenklo connections.
• Webhooks should trigger follow-up API requests with the user's credentials.
• You want webhook events and related API calls visible in Tenklo logs.
• You need real-time sync behavior without relying only on provider webhooks.

For outgoing webhooks from Tenklo to your app, see Receive webhooks from Tenklo.

How Tenklo fits inCopy Anchor Link

1. You register the Tenklo webhook URL in the provider's developer portal.
2. The provider sends events to Tenklo.
3. Tenklo attributes each event to the right integration and connection when possible.
4. Tenklo forwards the event to your app or routes it into a function.
5. If the event updates synced data, the function writes records to Tenklo's cache.

Common patternsCopy Anchor Link

• 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 nextCopy Anchor Link

• Webhook functions - set up provider webhooks and process them in functions.
• Webhook forwarding - forward external API webhooks through Tenklo to your app.
• Real-time syncs - combine provider webhooks with sync functions.
• Event functions - register provider webhooks after connection creation.
• Receive webhooks from Tenklo - configure your app's webhook URL and verify signatures.
• Sync functions - write changed records into Tenklo's cache.