---
title: "Test a callback URL"
method: POST
path: "/v1/publishers/callbacks/test"
tags: ["Server-Side"]
---

# Test a callback URL

`POST /v1/publishers/callbacks/test`

This endpoint is used to test a callback URL. It sends a test payload to the callback URL.

## Request body

- TestCallbackURLBody
  - `url` string, required
  - `data` object, required
  - `tags` object, required
  - `custom_fields` object, required

## Response `200`

OK

- object
  - `data` TestCallbackURLResponse
    - `response` TestCallbackURLResponseResponse, required
      - `status_code` integer, required — HTTP status from the tested callback URL, or 0 if the request failed before a response (see transport_error).
      - `body` string, required — The first 100 bytes of the response
      - `content_type` string, required — The content type of the response
      - `transport_error` string — Present when the HTTP client failed before a response (e.g. timeout, DNS, connection reset). Empty when status_code reflects the partner response.
    - `url` string, required
    - `legacy_macros` string[], required
    - `invalid_macros` string[], required

## Other responses

- `406` — VPN detected

---

[API](https://skmtc.net/bitlabs/apis/bitlabs-client-api.md) · [All operations](https://skmtc.net/bitlabs/apis/bitlabs-client-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitlabs/bitlabs-client-api/revisions/99209a6285bf/schema)