Webhook subscriptions
Subscribe to an event
POST
Creates a webhook endpoint that receives one event type. This is how the Zapier and Make apps subscribe; you can use it from your own code too. Webhooks need the Pro or Max plan.
bearerAuthheader
AuthorizationBearer <token>API key from Settings → API keys, sent as Authorization: Bearer ezqr_…. Requires the Max plan.
application/json- body
targetUrl*stringPublic HTTPS URL that receives the events
Format
uriLength
length <= 2048event*WebhookEventNameValue in
"qr.scanned""qr.created""qr.updated""qr.deleted""qr.destination_down""qr.destination_recovered""lead.created""card.viewed"source?stringShown in the dashboard so people know where the hook came from
Default
"api"Value in
"zapier""make""api"The subscription
application/json- response
id*stringFormat
uuidevent*WebhookEventNameValue in
"qr.scanned""qr.created""qr.updated""qr.deleted""qr.destination_down""qr.destination_recovered""lead.created""card.viewed"secret*stringSigning secret (whsec_…). Shown only once.
curl -X POST 'https://ez-qr.com/api/v1/hooks' \ -H 'Content-Type: application/json' \ -d '{ "targetUrl": "http://example.com", "event": "qr.scanned"}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "event": "qr.scanned", "secret": "string"}