Webhook subscriptions

Subscribe to an event

POST
/hooks

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.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API key from Settings → API keys, sent as Authorization: Bearer ezqr_…. Requires the Max plan.

Request Body

application/json
  1. body
targetUrl*string

Public HTTPS URL that receives the events

Formaturi
Lengthlength <= 2048
event*WebhookEventName
Value in"qr.scanned""qr.created""qr.updated""qr.deleted""qr.destination_down""qr.destination_recovered""lead.created""card.viewed"
source?string

Shown in the dashboard so people know where the hook came from

Default"api"
Value in"zapier""make""api"

Response Body

The subscription

application/json
  1. response
id*string
Formatuuid
event*WebhookEventName
Value in"qr.scanned""qr.created""qr.updated""qr.deleted""qr.destination_down""qr.destination_recovered""lead.created""card.viewed"
secret*string

Signing 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"}