---
title: "Verify an Agent webhook URL"
method: POST
path: "/agent/webhook/verify"
tags: ["Agents"]
---

# Verify an Agent webhook URL

`POST /agent/webhook/verify`

## Request

- Base URL: `https://api.fido.id/1.0`
- URL: `https://api.fido.id/1.0/agent/webhook/verify`
- Auth: none declared. Required headers: `x-api-key`

Verify that a public HTTPS endpoint is eligible to receive [Agent](https://docs.trustfull.com/docs/agents) alerts.

## Headers

- `content-type` string
- `accept` string
- `x-api-key` string, required

## Request body

- AgentWebhookVerificationRequest
  - `webhook_url` string, uri, required: The public HTTPS endpoint to verify.

## Response `200`

Webhook URL accepted

- AgentWebhookVerificationResponse
  - `status` 'ok', required

## Other responses

- `400`: The webhook URL is missing, invalid, or cannot be reached safely
- `401`: Invalid App Key
- `403`: The App Key is not enabled for Agents, which are part of the Enterprise plan

## Changes

- **2026-11-03** `be8ae1d26648`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trustfull/apis/products/changes/agent/webhook/verify/post.md)

---

[API](https://skmtc.dev/trustfull/apis/products.md) - [All operations](https://skmtc.dev/trustfull/apis/products/llms.txt) - [OpenAPI document](https://skmtc.dev/trustfull/apis/products/revisions/be8ae1d26648?raw)