POST · webhooks:write

Test webhook

Queue a signed test event for exactly one webhook endpoint.

External side effects

REST

POST/api/v1/webhooks/:endpointId/test

curl "https://www.stalkr.ai/api/v1/webhooks/:endpointId/test" \
  --request POST \
  --header "Authorization: Bearer $STALKR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: unique-operation-key"

MCP

Tool name: test_webhook

The MCP tool accepts the same input schema and returns the same structured { data, meta } result as REST.

Input

endpointIdrequired

string

idempotencyKey

string

Unique key used to safely retry this write operation

Safe retries

Pass idempotencyKey to the MCP tool or Idempotency-Key to REST when retrying this write.

Authorization

Required scope: webhooks:write.

Scope authorization is followed by resource authorization. Project operations check current membership and the minimum role required by the underlying workflow.

Related resources

REST conventions · MCP setup · Errors and limits