Skip to Content
Tracira
API referenceUtilities

Register a webhook subscription

Registers an outbound endpoint that receives evaluation and decision events (used by the Make.com “Watch verdicts” instant trigger). Events default to approved/rejected/changed when omitted.

posthttps://www.tracira.com/api/subscriptions
POST
/api/subscriptions

Authorization

webhookToken
headerAuthorizationBearer <token>

Workspace API token, from the Integrations page.

Request Body

application/json
  1. body
url*string

HTTPS endpoint to receive event payloads.

events?array<>

Events to deliver. Evaluation events: pass (no rule fired), flagged (needs a human), error (evaluation failed). Decision events: approved, rejected, changed (a reviewer edited it or asked for a redo), handled (a reviewer took over and did it themselves). Teaching event: taught (a manager left feedback on an output that had already gone out; the payload carries comment, and nothing is regenerated). Unrecognised values are ignored rather than rejected. Defaults to approved, rejected, changed.

source?string

Platform that registered the subscription (e.g. "make").

Response Body

This URL was already registered in the workspace: the existing subscription is reused (its events and source are updated) and its id returned. Registering the same URL again never creates a duplicate.

application/json
  1. response
id?string
url?string
events?array<string>|null
Example Request
curl -X POST 'https://www.tracira.com/api/subscriptions' \  -H 'Content-Type: application/json' \  -d '{  "url": "https://hooks.example.com/tracira",  "events": [    "approved",    "rejected",    "changed"  ],  "source": "make"}'
Example Response
{  "id": "string",  "url": "string",  "events": [    "string"  ]}