cURL webhook

Use the cURL webhook example when your deployment system can run a shell command after a release, but does not need a provider-specific workflow file.

Before you start

Create or edit a test plan, add a Webhook trigger, and copy the generated Webhook URL. Store it as a secret in your deployment system.

Basic request

curl --fail-with-body \
  -X POST "$KILLBUG_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  --data '{"message":"Deployment completed"}'

With a Base URL override

Use overrideBaseUrl when a deployment produces a preview, staging, or branch-specific URL:

jq -n \
  --arg message "Preview deployment completed" \
  --arg overrideBaseUrl "$DEPLOYMENT_URL" \
  '{ message: $message, overrideBaseUrl: $overrideBaseUrl }' |
curl --fail-with-body \
  -X POST "$KILLBUG_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  --data-binary @-

Verification

Action: Run the command after a deployment finishes.

Expected result: The command exits successfully and a new Killbug run appears for the test plan with trigger Webhook.

Action: Open the Killbug run.

Expected result: The run message matches the JSON message, and the tested URL is either the project's Base URL or the provided overrideBaseUrl.