Bulk creation

Create hundreds of QR codes at once from a CSV, Excel or VCF file, or with the batch API endpoint.

Bulk creation saves you from building codes one by one. Use it for shipment labels, product packaging, staff contact cards or a migration from another QR provider. You can upload a file in the dashboard or send a batch request to the API.

Both methods are available on the Max plan.

Import a file

Go to Settings → Bulk import. The import page has three tabs.

Pick the tab that matches your data and click Sample CSV to get a file with the right headers.

Optionally choose a Folder, then pick the Design for every code: one of your saved QR templates, a style preset, or plain.

Choose your file and click Start import. CSV, .xlsx and .xls files are accepted on the CSV tabs, up to 4 MB.

Watch the progress bar. The import runs in the background, so you can leave the page and check Recent imports later. Skipped rows are listed with their row number and reason.

Import rules

  • Each file can contain up to 5,000 rows or 5,000 contacts. Split larger files into batches.
  • Quoted values can contain commas and line breaks.
  • Rows with errors, such as a missing name or an unknown content_type, are skipped. Valid rows are still imported.
  • Codes with a target_url are dynamic and count toward your dynamic code limit. If the file has more dynamic codes than your plan has room for, the import doesn't start.
  • Codes are created in batches of 100. If your limit is reached part way through (for example, a teammate created codes at the same time), the import stops and keeps the codes already created.
  • Each imported code sends a qr.created webhook event and the import is recorded in the audit log.

Migrating from another provider

Export your codes as CSV from your current provider, then rename the columns to match EZQR's format. The import page lists where to find the export in QR Tiger, Beaconstac, Uniqode and ME-QR.

Batch API

POST /api/v1/qr-codes/batch creates up to 100 codes in one request. API access is included with Max. See Authentication for creating a key.

curl -X POST https://ez-qr.com/api/v1/qr-codes/batch \
  -H "Authorization: Bearer ezqr_..." \
  -H "Content-Type: application/json" \
  -d '{
    "codes": [
      {
        "name": "Table 1",
        "contentType": "link",
        "content": "https://example.com/menu?table=1",
        "type": "dynamic",
        "targetUrl": "https://example.com/menu?table=1"
      },
      {
        "name": "Guest Wi-Fi note",
        "contentType": "text",
        "content": "Ask staff for the Wi-Fi password"
      }
    ]
  }'

Each item accepts:

FieldRequiredNotes
nameYesDisplay name
contentTypeYesThe content type, for example link
contentYesThe content to encode
typeNostatic (default) or dynamic
targetUrlNoDestination for dynamic codes. If omitted, content is used when it's an http or https URL.
styleNoDesign options object

A successful request returns 201:

{ "data": { "created": 2, "errors": [] } }

Items that fail validation are skipped and described in errors, for example "Index 1: ...". Valid items are still created.

StatusMeaning
201Valid items were created
400The body isn't an array of codes, has more than 100 items, or no item is valid
403The batch would go over your dynamic code limit. No codes were created.

For the full endpoint reference, see the API reference.