---
title: "Queues one synthetic `flag.toggled` event for this subscription alone."
method: POST
path: "/api/v1/orgs/{org}/webhooks/{id}/test"
tags: ["Webhooks"]
---

# Queues one synthetic \`flag.toggled\` event for this subscription alone.

`POST /api/v1/orgs/{org}/webhooks/{id}/test`

## Request

- Base URL: `https://api.featureflip.io`
- URL: `https://api.featureflip.io/api/v1/orgs/{org}/webhooks/{id}/test`
- Auth: API key in header `Authorization`

Requires Admin.
Delivery is asynchronous — read the delivery log for the outcome. Refused with a 400 when
the subscription is disabled, and with a 403 `plan_limit_reached` when it is over the
plan's webhook allowance.

## Path parameters

- `org` string, required
- `id` string, required

## Response `202`

Accepted

- PublicTestWebhookSubscriptionResponse: The queued test event and its delivery. Poll the delivery log for the outcome.
  - `webhookEventId` string, uuid, required
  - `webhookDeliveryId` string, uuid, required

## Other responses

- `400`: The request is malformed, or it carries an If-Match header, which this endpoint can't evaluate. Send no If-Match, or `*`.
- `401`: Authentication is required, or the supplied API token is invalid or expired.
- `403`: Forbidden
- `404`: Not Found
- `429`: Rate limit exceeded. Retry after the interval indicated by the Retry-After header.

---

[API](https://skmtc.dev/featureflip/apis/management-api.md) · [All operations](https://skmtc.dev/featureflip/apis/management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/featureflip/apis/management-api/revisions/8a77e8581a45?raw)