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.
Use this for URL codes and other content types.
| Column | Required | Notes |
|---|---|---|
name | Yes | Display name in your dashboard |
content_type | Yes | One of link, text, email, sms, whatsapp, wifi, location, event, app, social, facebook, instagram, twitter, linkedin, tiktok |
content | Yes | The content to encode |
target_url | No | Makes the code dynamic, so you can change its destination after printing |
name,content_type,content,target_url
Shipment 001,link,https://tracking.example.com/001,https://tracking.example.com/001
Product Page A,link,https://example.com/products/a,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
nameor an unknowncontent_type, are skipped. Valid rows are still imported. - Codes with a
target_urlare 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.createdwebhook 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:
| Field | Required | Notes |
|---|---|---|
name | Yes | Display name |
contentType | Yes | The content type, for example link |
content | Yes | The content to encode |
type | No | static (default) or dynamic |
targetUrl | No | Destination for dynamic codes. If omitted, content is used when it's an http or https URL. |
style | No | Design 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.
| Status | Meaning |
|---|---|
201 | Valid items were created |
400 | The body isn't an array of codes, has more than 100 items, or no item is valid |
403 | The batch would go over your dynamic code limit. No codes were created. |
For the full endpoint reference, see the API reference.