Subscribe to events
Subscribes a URL to events, the REST Hooks way Zapier, Make and n8n call it (Business).
QRdx posts each event to the URL, signed with the secret in the response, which is shown only once (verifying signatures). Send the URL as target_url (or targetUrl, hookUrl, hook_url or url) and one event or several events.
With a signed-in browser session instead of a key or token, it needs a recent "Confirm it's you" (CONFIRMATION_REQUIRED otherwise).
Scope: codes:write, for API keys and OAuth tokens alike.
AuthorizationBearer <qrdx_ followed by 40 letters and digits>An API key, sent as Authorization: Bearer qrdx_…. Create one in Settings → API keys & apps: it is shown once. A key acts on the workspace it was created in as its creator, with their current role there, and only within its scopes, the same scopes as OAuth (each operation names the one it needs). API keys.
application/json- body
target_url?stringtargetUrl?stringhookUrl?stringhook_url?stringurl?stringevent?string"scan.created""scan.milestone""code.created""code.updated""form.submitted"events?array<>1 <= items <= 5Subscribed; secret is shown only here
application/json- response
id*stringtarget_url*stringWhere events are posted; only the origin unless the caller manages hooks (codes:write)
events*array<>event*|The event, when the subscription has exactly one
active*booleancreated_at*stringCreated (ISO 8601, UTC)
date-timesecret*stringSigning secret for the X-QRdx-Signature header, shown only in this response
curl -X POST 'https://api.qrdx.dev/v1/hooks' \ -H 'Content-Type: application/json' \ -d '{ "target_url": "https://hooks.zapier.com/hooks/catch/123456/abcdef/", "event": "scan.created"}'{ "id": "cm5hook0zapier0scans00001", "target_url": "https://hooks.zapier.com/hooks/catch/123456/abcdef/", "events": [ "scan.created" ], "event": "scan.created", "active": true, "created_at": "2026-01-05T09:30:00.000Z", "secret": "whsec_9f2d7c1b8e4a6f3d0c5b2a7e1f8d4c6b"}Last updated on