---
title: "Test Subscription"
method: POST
path: "/api/subscriptions/{id}/test"
tags: ["Webhooks"]
---

# Test Subscription

`POST /api/subscriptions/{id}/test`

Test a webhook subscription by sending a test signal. Supports three test modes.

*Endpoint*: **(POST) https://api.lusha.com/api/subscriptions/{id}/test**
---
**Test Modes:**
- `direct` - Quick HTTP check only (validates URL responds correctly)
- `kafka` - Fanout handler only (tests Kafka message processing)
- `full` - Complete Kafka flow (default - end-to-end test)

**Important Notes:**
- Test deliveries do NOT consume credits
- Test payloads use mock data
- Useful for verifying webhook configuration before going live

## Path parameters

- `id` string, required

## Query parameters

- `mode` 'direct' | 'kafka' | 'full'

## Response `200`

Test executed successfully

- TestSubscriptionResponse
  - `subscriptionId` string, required
  - `subscriptionName` string
  - `url` string, uri, required
  - `mode` 'direct' | 'kafka' | 'full', required
  - `flowCheck` object
    - `success` boolean
    - `statusCode` integer
    - `durationMs` integer
  - `testPayload` object
    - `entityType` string
    - `signalType` string
    - `data` object
  - `isSuccess` boolean, required
  - `timestamp` string, date-time, required

## Other responses

- `400` — Bad request - invalid input data
- `401` — Unauthorized - invalid or missing API key
- `403` — Subscription does not belong to your account
- `404` — Not found - resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/lusha/apis/lusha-api-documentation.md) · [All operations](https://skmtc.net/lusha/apis/lusha-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lusha/lusha-api-documentation/versions/4c51e40e3e67/schema)