Skip to main content

Events & webhooks

Preview

This API is in active development. Shapes and URLs are illustrative and may change before GA.

Send an event​

Fire a conversion or custom event:

curl -X POST https://api.gtmclarity.ai/v1/events \
  -H "Authorization: Bearer $GTMC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "conversion", "goal": "booked_demo", "visitor_id": "vis_123" }'

Receive events​

Register an endpoint to receive events as they happen — see Webhooks for the event list, payload shape, and signature verification.