Managing webhooks

Managing webhooks#

This guide explains how to create and enable webhooks in Adverity so you can trigger automated workflows when key events occur.

Introduction#

Webhooks send an HTTP request to your endpoint when selected events occur in Adverity. Use webhooks to notify external systems (for example, your monitoring tools or automation workflows) without polling.

You can only create webhooks for workspaces where you have Notifications Administrator privileges. For more information, see Managing user permissions.

Creating a webhook#

Prerequisites#

Before you complete the procedure in this guide, ensure you have the following:

  • A reachable endpoint (recommended: HTTPS) that can receive HTTP requests from your Adverity instance.

  • A secret value that you store securely and can use to verify webhook requests in your system.

Procedure#

To create a webhook, follow these steps:

  1. Go to the Administration page.

  2. In the secondary menu, in the Notifications section, click Webhooks.

  3. In the top right corner, click Create Webhook.

  4. In Payload URL, enter the URL of your endpoint.

  5. In Secret, enter the secret value used by your system to verify webhook requests.

  6. From the Events drop-down list, select one or more events:

    • Destinations Sync End

    • Extract No Data Collected

    • Issue Created

  7. (Optional) Turn on Enabled to activate the webhook immediately. If you leave Enabled turned off, you can enable the webhook later.

  8. Click Save.

Note

Use a publicly reachable HTTPS endpoint for production. Keep the secret value private and rotate it if it is exposed.

Contents