---
title: "Test webhook"
method: POST
path: "/v1/twitter/stream/webhooks/test"
tags: ["Stream Webhooks"]
---

# Test webhook

`POST /v1/twitter/stream/webhooks/test`

Send a test payload to the webhook configured for a stream monitor. Returns the HTTP status code and response time from the webhook endpoint. Useful for verifying webhook connectivity before going live.

## Request body

- object
  - `monitor_id` string, required — The ID of the stream monitor whose webhook to test.

## Response `200`

Webhook test result.

- object
  - `success` boolean — Whether the webhook responded with a 2xx status code.
  - `status_code` integer, nullable — HTTP status code returned by the webhook endpoint.
  - `response_time_ms` number, nullable — Response time in milliseconds.
  - `error` string, nullable — Error message if the webhook test failed.

## Other responses

- `401` — Authentication failed. The API key is missing, invalid, or expired.
- `402` — Insufficient credits. Your account balance has been exhausted. Purchase more credits at https://scrapebadger.com/dashboard/billing.
- `429` — Rate limit exceeded. Too many requests in a given time period. Implement exponential backoff and retry.

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)