Skip to main content
PATCH
/
qrcode
/
{qrid}
/
curl --request PATCH \
  --url https://management.scanova.io/qrcode/{qrid}/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "lead_list": 221
}'
{}

​
Overview

Attaches a lead list to a QR code. When users scan the QR code, they will be prompted to fill out the lead capture form before accessing the content.

​
Path Parameters

ParameterTypeRequiredDescriptionExample
qridstringYesQR code IDQc3ca09e1a5574caf

​
Request Body

FieldTypeRequiredDescriptionExample
lead_listintegerYesLead list ID to attach to the QR code221

​
Examples

​
Attach Lead List to QR Code

curl -X PATCH "https://management.scanova.io/qrcode/Qc3ca09e1a5574caf/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_list": 221
  }'

​
Response

Returns the updated QR code object with the lead list information included in the dynamic_url_object.

​
Lead List Behavior

When a lead list is attached to a QR code:
  1. User scans QR code
  2. Lead capture form is displayed (based on lead list configuration)
  3. User fills out the form (or skips if allowed)
  4. User is redirected to the original QR code content
  5. Lead data is captured and sent to configured webhooks

​
Important Notes

  • One Lead List Per QR Code: Each QR code can only have one lead list attached
  • Multiple QR Codes: One lead list can be attached to multiple QR codes
  • Active Lead Lists Only: Only active lead lists can be attached
  • Immediate Effect: Changes take effect immediately

​
Use Cases

  • Lead Generation: Capture leads from QR code scans
  • Event Registration: Collect attendee information at events
  • Customer Feedback: Gather feedback before accessing content
  • Contact Collection: Build contact lists from QR code interactions
  • Survey Data: Collect survey responses through QR codes
The lead list must be active (is_active: true) to be attached to a QR code. If you try to attach an inactive lead list, the request will fail.
Attaching a lead list to a QR code will immediately start capturing leads. Make sure your lead list is properly configured and your webhooks are set up before attaching.

Authorizations

​
Authorization
string
header
required

API key authentication. Enter your API key directly in the Authorization header.

Path Parameters

​
qrid
string
required

QR code ID

Body

application/json
  • Option 1
  • Option 2
​
lead_list
integer
required

Lead list ID to attach to the QR code

Example:

221

Response

QR code updated successfully

Updated QR code object with lead list information