Webhooks

Webhooks let your system receive real-time notifications when events occur on the Tesouro platform. Tesouro delivers these as HTTP POST requests to an endpoint you register. Unlike polling the API, webhooks push data to you when an event occurs reducing latency and API load.

​

How it works

Embedded banking webhooks use a subscription model. You explicitly subscribe to the event types you want to receive, and Tesouro delivers matching events to your registered endpoint. Each subscription is created and managed through the managing subscriptions guide.

​

Supported events

See Event types for the attributes and example payload for each event.

​

Payload structure

Every webhook delivery shares the same envelope. Only the eventType value and the contents of attributes differ between events.

​

Next steps

• Managing subscriptions: create and manage your webhook subscriptions
• Event types: payload schemas for each event
• Delivery and retry behavior: how Tesouro delivers events and retries failures