How to set external QR and barcode values on a participant

Use this guide when you need to assign QR code or barcode identifiers from an external system (e.g. a registration or access control platform) to a participant's account.

⚠️ These fields are global. external_qr and external_barcode are stored at the environment level. Updating them in one event will cascade to every other event this account is attached to within the same data environment.

What you'll need before starting

What you need	Where to get it
Participant ID, External ID, or email	`GET /api/v2/account/get` or `GET /api/v2/participants/{eventId}/list`

Request — set both QR and barcode

Bash

curl -X POST "https://your-event-domain.com/api/v2/account/set" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "id=12345" \
  -F "external_qr=QR-2025-A1B2C3" \
  -F "external_barcode=BC-9876543210"

Request — set only QR

Bash

curl -X POST "https://your-event-domain.com/api/v2/account/set" \
  -H "Authorization: Bearer your_api_key_here" \
  -F "event_id=7" \
  -F "id=12345" \
  -F "external_qr=QR-2025-A1B2C3"

Notes

external_qr and external_barcode are independent fields — you can set one or both
These fields are distinct from external_id. Use external_id for system-level record matching. Use external_qr and external_barcode for on-site scanning and badge-related identifiers
Both accept free-form string values — there is no format validation
You can identify the participant by id, external_id, or email