---
title: "Send a sample payload now and return the provider response"
method: POST
path: "/v1/destinations/{destinationId}/test"
tags: ["destinations"]
---

# Send a sample payload now and return the provider response

`POST /v1/destinations/{destinationId}/test`

## Request

- Base URL: `https://postbag.dev`
- URL: `https://postbag.dev/v1/destinations/{destinationId}/test`
- Auth: HTTP bearer

Verifies a destination is actually reachable and configured correctly — do this right after creating one, before wiring routes to it.

## Path parameters

- `destinationId` string, required

## Request body

- object
  - `sample` object: Override the default sample payload sent for the test.

## Response `200`

result

- DeliveryResult
  - `ok` boolean
  - `status_code` integer, nullable
  - `latency_ms` number
  - `response_excerpt` string
  - `error` string, nullable

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Not found
- `409`: Error
- `422`: Error

---

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