Can I create QR codes in bulk?

What exists today

There is no CSV upload anywhere. The API takes JSON rows, so a spreadsheet has to be converted before it is sent. For the marketing overview of the feature, see the bulk QR code generator page.

Create codes in bulk through the API

1. Be on the Business plan. The bulk endpoint refuses Starter and Pro keys.
2. Make a key. Go to Settings → API, click New key, and tick qr:bulk alongside qr:write. The key is shown once — copy it immediately. You can hold up to 5 active keys.
3. Post your rows. Each entry needs a type and a destination_url; name is optional but worth setting, because it is what you will search on later.

curl -X POST https://qrcodestack.com/api/v1/qr-codes/bulk \
  -H "Authorization: Bearer qrs_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      { "type": "url", "name": "LAP-0001", "destination_url": "https://inventory.example.com/items/LAP-0001" },
      { "type": "url", "name": "LAP-0002", "destination_url": "https://inventory.example.com/items/LAP-0002" }
    ]
  }'

The response returns created_count, failed_count, and a results array with one entry per row, in the order you sent them, so a partial failure tells you exactly which row to retry. Full reference at /api-docs.

Limits worth knowing before you script it

• 500 rows per request. Split a larger job into batches.
• Every code is dynamic. The API does not create static codes.
• Codes count against your plan. Business includes 600 dynamic codes; the batch fails rows beyond that limit.
• Rate limits: 600 requests per minute and 100,000 per month on Business.
• Destinations are safety-checked. A row pointing at a flagged URL fails with the rest of the batch still created.
• No ZIP download. Fetch each code's image individually from its own endpoint.

If you are not on the Business plan

Create the codes one at a time in the wizard and lean on organisation instead of automation. Name each code with the identifier it stands for, put a run of codes in one Folder, and tag them by category so the list stays searchable — see folders and tags.

For a few dozen items that is genuinely faster than writing a script. Our walkthrough of tracking inventory from a spreadsheet works this way end to end.

Frequently asked questions