Endpoint responsible for removing a webhook configured in the account.

The request uses the webhook identifier (id) in the endpoint:

DELETE /v3/webhooks/{id}

When a webhook is removed:

• new events will no longer be sent to the configured URL
• Asaas immediately stops delivery attempts related to that webhook
• the integration will stop receiving automatic notifications associated with the removed configuration

When to use this endpoint

This endpoint should be used whenever it is necessary to discontinue receiving automatic notifications, for example:

• deactivating an integration
• changing the event delivery URL
• removing old environments or invalid URLs
• shutting down an integrated application
• restructuring the webhook architecture

❗️

Attention

This action cannot be undone.

• After removing the webhook, a new configuration must be created if you want to receive events automatically again.

Impact of the removal

After deletion:

• future events will no longer be sent to the removed webhook
• automatic retry attempts will stop occurring
• the removed identifier cannot be reused

If your application still depends on receiving events, it is recommended to first verify whether there is another active webhook properly configured.

Parameters

• id

  • string • required - Unique identifier of the webhook configured in Asaas.