---
title: "Test Webhook Url"
method: POST
path: "/v0/webhooks/test"
tags: ["Webhooks"]
---

# Test Webhook Url

`POST /v0/webhooks/test`

Send a test event to verify connectivity and payload handling. Either provide a webhook_id to test an existing webhook (with optional url/secret overrides), or provide url and event_type directly to test before creating a webhook.

## Request body

- WebhookTest
  - `webhook_id` integer, nullable — ID of an existing webhook to test. When provided, url and event_type are loaded from the stored webhook. Body fields (url, secret) can override stored values.
  - `url` string, uri, nullable — URL to send the test event to. Required when webhook_id is not provided.
  - `event_type` 'job_new' | 'company_new' | 'job_closed'
  - `secret` string, nullable — Secret used to sign webhook payloads with HMAC-SHA256. If set, deliveries include an X-TheirStack-Signature-256 header.

## Response `200`

Successful Response

- WebhookTestResponse
  - `status` integer, required
  - `message` string, nullable
  - `signature` string, nullable

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/2723cd54b43e/schema)