Webhooks let external services trigger your Autohive agents automatically. When a POST request is sent to a webhook URL, the associated agent runs with the request payload as its input.

Access Webhooks by clicking the Webhooks tab in your workspace header.

Creating a webhook

  1. Click Create webhook.
  2. Give the webhook a Name.
  3. Select the Agent that should run when the webhook is triggered.
  4. Click Create Webhook.

A unique webhook URL is generated automatically. Copy it using the copy button and provide it to the external service that will be sending requests.

Webhook URL

Each webhook has a unique URL in the format:

  https://app.autohive.com/{workspace}/hooks/{secret}

The secret embedded in the URL acts as the authentication token — no additional headers or signatures are required. You can copy the URL at any time from the webhook list or the edit form.

Testing a webhook

Before connecting an external service, you can test your webhook directly from Autohive:

  1. Open the three-dot menu on a webhook and select Test.
  2. Enter a JSON payload in the Test Payload field.
  3. Click Send Test.

The result shows whether the webhook triggered successfully and how long it took. You can click Send Again to re-run the test with the same or an updated payload.

Managing webhooks

The webhooks list shows all webhooks in your workspace with the following columns:

ColumnDescription
WebhookName, associated agent, and a badge showing any new failed executions
Created byThe member who created the webhook
URLThe webhook URL with a copy button
ActionsToggle on/off and access the options menu

Use the search bar to filter by name.

Enabling and disabling

Use the toggle switch on each webhook to turn it on or off. Disabled webhooks will not trigger when called.

Options menu

Click the three-dot menu on any webhook to:

  • Edit — update the name or associated agent
  • Test — send a test payload
  • Delete — permanently remove the webhook

Execution history

Click any webhook in the list to open its execution history. Each execution shows:

  • Status — Succeeded, Failed, or Timed out
  • Date and time it was triggered
  • Error message if it failed

For successful executions, click View to open the agent conversation and see the output.

Handling failures

When an execution fails, a badge appears on the webhook showing the number of new issues. From the execution history you can:

  • Click Dismiss to acknowledge a failure and clear it from the badge count
  • Click Dismiss all issues to clear all unacknowledged failures at once

If the associated agent was deleted, an Assign another agent button will appear so you can reassign the webhook without recreating it.