---
title: "Test Webhook"
method: POST
path: "/webhook/{id}/test"
tags: ["Monitoring"]
---

# Test Webhook

`POST /webhook/{id}/test`

## Request

- Base URL: `https://api.twitterapis.com/twitter`
- URL: `https://api.twitterapis.com/twitter/webhook/{id}/test`
- Auth: HTTP bearer

Sends a single HMAC-signed test event to this webhook's URL right now and returns the outcome synchronously. Unlike a real monitor event, a test send is never queued, retried, or dead-lettered: it is a one-shot diagnostic so you can confirm your endpoint and signature verification both work before relying on the webhook. Cost: Free per call.

## Path parameters

- `id` string, required

## Response `200`

Fire one real signed test delivery and see the result immediately.

- object
  - `id` string: The webhook's id.
  - `delivered` boolean: True if your endpoint returned a 2xx within the delivery timeout.
  - `status_code` integer, nullable: The HTTP status your endpoint returned, or null if the request failed before a response was received (timeout, connection refused, DNS failure, or an egress-safety refusal).
  - `error` string, nullable: Human-readable failure reason when delivered is false, or null on success.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

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