---
title: "Send Test Event"
method: POST
path: "/v1/webhooks/{id}/test"
tags: ["Webhooks"]
---

# Send Test Event

`POST /v1/webhooks/{id}/test`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/webhooks/{id}/test`
- Auth: API key in header `anchor-api-key`

Fire a synthetic event of the given type through the real signing + retry
path. Useful during development for confirming your endpoint can verify
the signature and is reachable from Anchor's egress IPs.

The synthetic delivery counts toward your delivery log so you can see it
in `GET /v1/webhooks/{id}/events`.

## Path parameters

- `id` string, required

## Request body

- WebhookTestRequest
  - `event_type` 'task.completed' | 'task.failed' | 'task.cancelled' | 'task.healed' | 'session.ready' | 'session.completed' | 'session.failed' | 'session.recording.ready' | 'batch.completed' | 'batch.failed' | 'intervention.requested' | 'intervention.resolved' | 'identity.authenticated' | 'identity.authentication_failed', required: Catalog of webhook event types Anchor can deliver. Adding a new event type is a coordinated change between session-manager (publisher), webhook-dispatcher (consumer), and the dashboard.

## Response `202`

Synthetic event accepted and enqueued for delivery.

- WebhookTestResponse
  - `external_event_id` string, required: The synthetic event id that will appear on the receiver as `id` in the envelope.
  - `event_type` 'task.completed' | 'task.failed' | 'task.cancelled' | 'task.healed' | 'session.ready' | 'session.completed' | 'session.failed' | 'session.recording.ready' | 'batch.completed' | 'batch.failed' | 'intervention.requested' | 'intervention.resolved' | 'identity.authenticated' | 'identity.authentication_failed', required: Catalog of webhook event types Anchor can deliver. Adding a new event type is a coordinated change between session-manager (publisher), webhook-dispatcher (consumer), and the dashboard.

## Other responses

- `400`: Unknown event type.
- `404`: Webhook not found in this project.
- `500`: Failed to enqueue test event.

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/changes/v1/webhooks/:id/test/post.md)

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) - [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/revisions/9d755f22df0e?raw)