> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trio.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# First Webhook

***

Webhooks allow Trio to notify your application whenever an event occurs, eliminating the need to constantly poll the API for updates.

To create your first webhook, follow the steps below.

1. In the lower-left menu, click the **Settings** icon;
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-1.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=9758d3181447d8cd2f6140f4f471afaf" alt="Image" width="3022" height="1620" data-path="images/image-1.png" />
   </Frame>
2. In the dropdown menu, select **"Webhooks"**;
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-2.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=bb4c92ecb9ffd5ff21c2baafadc17a67" alt="Image" width="3000" height="1540" data-path="images/image-2.png" />
   </Frame>
3. Click **"Create Webhook"**;
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-3.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=6681cbcf8dd1acd0e17ae59ada7d0e67" alt="Image" width="3012" height="1530" data-path="images/image-3.png" />
   </Frame>
4. Fill in the **Notification URL**.
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-4.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=95c0c5201b9059b7134561befffe3816" alt="Image" width="1988" height="1036" data-path="images/image-4.png" />
   </Frame>

This is the HTTPS endpoint where Trio will deliver webhook notifications. Make sure your endpoint is publicly accessible and capable of receiving HTTP POST requests.

5. (Optional) Select an **Entity**.
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-5.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=dbfe0767ea70c32c7cb4822a67dbd0e6" alt="Image" width="2402" height="1126" data-path="images/image-5.png" />
   </Frame>

If you leave this field empty, the webhook will receive events from **all entities** in your account.

If you select a specific entity, the webhook will only receive events related to that entity.

6. (Optional) Select a **Bank Account**.
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-6.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=5a4251e36445b181cfb0ef597baa0452" alt="Image" width="2386" height="1130" data-path="images/image-6.png" />
   </Frame>

After selecting an Entity, you can further filter notifications by choosing one of its Bank Accounts.

Only events generated by that Bank Account will be delivered to this webhook.

7. Select the **Events that will trigger the webhook**.
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-7.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=fa8020c6cabf68341119d611f7f0133d" alt="Image" width="2910" height="1446" data-path="images/image-7.png" />
   </Frame>

Choose the event types your application should receive.

For most Pix integrations, the recommended events are:

* **Payment Document** (Pix Cash Out)
* **Collecting Document** (Pix Cash In)

You can also subscribe to any other events that are relevant to your integration.

8. Enter a **Secret**.
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-9.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=d8af364ef14fa8d19ac791c2895cf3c8" alt="Image" width="2830" height="1392" data-path="images/image-9.png" />
   </Frame>

You can also subscribe to any other events that are relevant to your integration. Enter a Secret.

Choose any secret value that only your application knows. This value is used by Trio to generate a unique signing key for your webhook. Whenever a webhook is delivered, Trio includes HTTP header:

x-webhook-signature – contains the HMAC-SHA256 signature of the request body.

Your application should compute the HMAC-SHA256 hash of the received payload using the webhook signing key available in the webhook details page, then compare it with the value received in x-webhook-signature.

If both signatures match, you can safely verify that:

* the request was sent by Trio;
* the payload was not modified during transmission.

9. Click **Save Webhook**.
   <Frame>
     <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-10.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=e7d44926b03b8a0e21b6bbd3cb80a65a" alt="Image" width="2182" height="1006" data-path="images/image-10.png" />
   </Frame>
10. Save the webhook secret in details
    <Frame>
      <img src="https://mintcdn.com/trio-372e8dab/-nKZgppWVUd8nree/images/image-11.png?fit=max&auto=format&n=-nKZgppWVUd8nree&q=85&s=1a59458772bd6250957e6c5bf6504333" alt="Image" width="2708" height="1428" data-path="images/image-11.png" />
    </Frame>

Your webhook is now active and ready to receive notifications.

For more information about webhook payloads, events, and signature validation, see the Webhooks documentation.

[Webhook Documentation](/webhooks/introduction)
