---
title: "Test webhook"
method: POST
path: "/v1/webhooks/{id}/test"
tags: ["Webhooks"]
---

# Test webhook

`POST /v1/webhooks/{id}/test`

## Request

- Base URL: `https://smtpfa.st/api`
- URL: `https://smtpfa.st/api/v1/webhooks/{id}/test`
- Auth: HTTP bearer

Send a test event payload to the webhook URL and return the delivery result. Useful for verifying that your endpoint is reachable and responds correctly.

## Path parameters

- `id` string, required

## Response `200`

Test delivery result

- object
  - `success` boolean: Whether the test payload was delivered successfully
  - `status` integer, nullable: HTTP status code returned by the webhook endpoint, null when it did not answer
  - `message` string
  - `delivery` WebhookDelivery
    - `object` string
    - `id` string
    - `webhook_id` string
    - `event` string
    - `status` 'pending' | 'sending' | 'succeeded' | 'failed'
    - `attempts` integer
    - `max_attempts` integer
    - `status_code` integer, nullable
    - `duration_ms` integer, nullable
    - `error` string, nullable
    - `response` string, nullable: First 500 characters of the last response body
    - `attempt_log` object[]
      - `at` string, date-time
      - `status_code` integer, nullable
      - `duration_ms` integer
      - `error` string, nullable
    - `next_attempt_at` string, date-time, nullable
    - `delivered_at` string, date-time, nullable
    - `created_at` string, date-time

## Other responses

- `401`: Invalid or missing API key
- `404`: Resource not found
- `429`: Rate limit exceeded - retry after the period indicated in the Retry-After header
- `500`: Internal server error

---

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