POST · webhooks:write

Create webhook

Create a signed HTTPS webhook endpoint for workspace or project events. The signing secret is returned once.

External side effects

REST

POST/api/v1/webhooks

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

MCP

Tool name: create_webhook

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

Input

projectId

string | null

namerequired

string

urlrequired

string

eventTypesrequired

array

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