Create new Webhook via web application

You can create new Webhooks using the Asaas web application. To do this, access User Menu > Integrations > Webhooks.

In your first access, you will see a button to create your first Webhook.

---

When clicking on "Create Webhook", a form for more information will appear. In the first step, you need to:

• Define a name;
• Define the URL that will receive the event information;
• Register an email that will be notified in case of communication errors;
• What API version;
• Define an authentication token: this token will be sent in the asaas-access-token header in all Asaas calls to your application. You can enter your own token or click the "Gerar token" button to have Asaas create a secure value for you.
• Whether the synchronization queue is activated;
• Whether the Webhook is activated;
• What type of sending: check out the article on the available sending types.

🚧

Secure authentication token

The token must follow minimum security requirements. A secure token must have:

• Between 32 and 255 characters;
• No white spaces;
• Absence of numerical sequences (e.g., 12345) or 4 repeated letters;
• Cannot be an Asaas API key.

To simplify your integration, we added the "Gerar token" button, which fills the field with a token that meets all requirements.

Following the setup, you will need to select the events you wish to receive. You can check the complete list of events in our documentation. Just select the events you want to receive across various different products.

---

You can have up to 10 Webhooks configured per account without address restrictions. You can also edit or delete created Webhooks.