Send a test message

POSThttps://api.checkslip.com/api/webhooks/endpoints/{endpoint_id}/test

API key

Sends a webhook.test message to this endpoint, signed and retried like a real one, so you can see that your system receives messages and checks signatures. Uses no credits and carries no transfer data. The response is the queued delivery; follow it with the id in the response. A disabled endpoint cannot be sent to (ENDPOINT_DISABLED). An Idempotency-Key is required. Needs an API key with webhook:manage.

Parameters

Field	In	Type	Required
`endpoint_id`	path	`string`	yes
`traceparent`	header	`string`	no
`Idempotency-Key`	header	`string`	yes

Responses

202 `application/json`

Field	Type	Required
`id`	`string`	yes
`message_id`	`string`	yes
`endpoint_id`	`string`	yes
`event_type`	`slip.checked \| webhook.test`	yes
`request_id`	`string (uuid) \| null`	yes
`status`	`PENDING \| RETRYING \| SUCCEEDED \| FAILED \| CANCELLED`	yes
`attempt_count`	`integer`	yes
`next_attempt_at`	`string (date-time) \| null`	yes
`last_attempt_at`	`string (date-time) \| null`	yes
`last_http_status`	`integer \| null`	yes
`created_at`	`string (date-time)`	yes

Possible errors

400401403404409422

An error as Problem Details. All codes are listed at Error codes

curl -X POST https://api.checkslip.com/api/webhooks/endpoints/string/test \
  -H "Authorization: Bearer $CHECKSLIP_API_KEY" \
  -H "Idempotency-Key: order-1042-slip-1"

const res = await fetch("https://api.checkslip.com/api/webhooks/endpoints/string/test", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CHECKSLIP_API_KEY}`,
    "Idempotency-Key": "order-1042-slip-1",
  },
});
const data = await res.json();

import os

import requests

res = requests.post(
    "https://api.checkslip.com/api/webhooks/endpoints/string/test",
    headers={
        "Authorization": f"Bearer {os.environ['CHECKSLIP_API_KEY']}",
        "Idempotency-Key": "order-1042-slip-1",
    },
)
data = res.json()

Example response

{
  "id": "string",
  "message_id": "string",
  "endpoint_id": "string",
  "event_type": "slip.checked",
  "request_id": "0b6c2f5e-8a41-4d1e-9c3a-5f7e2d18a6b4",
  "status": "PENDING",
  "attempt_count": 1,
  "next_attempt_at": "2026-11-05T09:30:00+07:00",
  "last_attempt_at": "2026-11-05T09:30:00+07:00",
  "last_http_status": 1,
  "created_at": "2026-11-05T09:30:00+07:00"
}

Parameters#

Responses#

202 application/json#

Possible errors#

Parameters

Responses

202 `application/json`

Possible errors