Kalpana Docs
Resources

Send a test event

Send a webhook.test event to an endpoint now and get its answer.

POST /api/webhooks/{id}/test

Requires webhooks:update and an active subscription.

NameTypeRequiredDescription
workspacestringYesWorkspace slug or id.
curl --request POST "https://app.kalpana.one/api/webhooks/0192f8a4-6c1e-7c3a-9b0e-4d2f1a7e5c11/test" \
  --header "x-api-key: $KALPANA_API_KEY" \
  --header "content-type: application/json" \
  --data '{"workspace":"acme"}'

Response

{
  "deliveryId": "0192f8a4-7d2e-7a10-8c3b-5e1f2a9d4b22",
  "status": "succeeded",
  "responseStatus": 200,
  "durationMs": 342,
  "error": null
}

The webhook.test event is sent whatever the endpoint subscribes to, and the call waits for the answer. status is succeeded, failed, or skipped when it was not sent. error says why a test failed or was skipped. A test is not retried. If the URL answers 405 or 410, the endpoint is turned off.

Errors

StatusCause
402The organization has no active subscription.
403Your role or key lacks webhooks:update.
404The endpoint is not in this workspace.
409The endpoint is turned off. Turn it on with Change an endpoint first.
429A test was sent to this endpoint in the last few seconds. Wait and try again.
503The test could not be sent right now. Try again in a moment.
Was this page helpful?

Updated 4 Nov 2026

On this page