Skip to content
oqur

Hundreds of codes, one file.

Do not create codes one by one for table cards, product labels or staff business cards. Upload a CSV file, map the columns, see the faulty rows and create them all in one go. Soon you will be able to do the same with the API.

  • Business and above

Sample screen: bulk code creation from a CSV file

Bulk creation

Kafe Rıhtım · Business plan

SAMPLE DATA
  1. File
  2. 2 Map columns
  3. 3 Create

tables.csv

48 rows · 3 columns · UTF-8

Map columns

How the CSV columns map to oqur fields
CSV columnoqur field

Folder

Preview

5 of 48 rows

codes will be created ·

Request
curl -X POST https://api.oqur.io/v1/qr-codes/bulk \
  -H "Authorization: Bearer $OQUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "folder": "Alsancak branch",
    "template": "Rıhtım",
    "codes": [
      { "name": "Table 01", "type": "url",
        "url": "https://kaferihtim.com/menu?table=01" },
      { "name": "Table 02", "type": "url",
        "url": "https://kaferihtim.com/menu?table=02" }
    ]
  }'

Response

{
  "created": 2,
  "codes": [
    { "id": "qr_7Kq2xP",
      "short_url": "https://oqur.io/d/7Kq2xP" },
    { "id": "qr_8Lr3Hm",
      "short_url": "https://oqur.io/d/8Lr3Hm" }
  ]
}

The API is coming soon. When it arrives, you will create your key in the Developer section of your account settings. The endpoints are a draft.

API documentation

Change the column mapping and see how the preview reacts. The API tab shows how the same job will be done in a single request with the API coming soon.

From file to folder.

Bulk creation turns hundreds of rows to enter by hand into a single checking step.

What should your file look like?

Each row is a code, each column a field; the first row is the header. You do not have to match the column names to oqur; you map them after uploading. Save the file as UTF-8 for Turkish characters.

name,address,branch
Table 01,https://kaferihtim.com/menu?masa=01,Alsancak
Table 02,https://kaferihtim.com/menu?masa=02,Alsancak
Table 01,https://kaferihtim.com/menu?masa=k01,Karşıyaka
tables.csv: separated by commas or semicolons, UTF-8.

Errors show before anything is created

Every row is checked in the preview: a missing address, an invalid link, a repeated name. You can fix the faulty rows and upload again, or skip them and create the rest.

  • Row 14The address is empty.
  • Row 31Invalid link: “kaferihtim,com/menu”.
  • Row 40The same name already exists in this folder; (2) will be added to the end.

The design and folder are chosen together

In bulk creation you choose a design template and a destination folder. All the codes look the same, land in the same folder and download as a single ZIP file.

  1. Choose a template

    For example “Rıhtım”.

  2. Choose a folder

    Or spread them by the branch column in the CSV.

  3. Download the ZIP

    PNG, SVG, PDF or EPS.

Coming soon: automate with the API

If your product catalogue lives in another system, you will not need to upload codes by hand. With the REST API, coming soon, you will be able to create codes, update their destinations and pull their statistics.

POST /v1/qr-codes
Create a code
PATCH /v1/qr-codes/{id}
Update the destination or design
GET /v1/analytics/scans
Scan statistics
POST /v1/qr-codes/bulk
Many codes in a single request

About Bulk creation

If the answer is not here, look at the FAQ page or write to us.

All questions

The number of codes you can create depends on your plan's dynamic code limit. The Business plan has 500 dynamic codes in total.

In Excel, just save the file as “CSV UTF-8”. Choose UTF-8 encoding so that Turkish characters are not garbled.

Yes. Each row is a separate dynamic code; you can change its destination, design and folder independently of the others.

Forty-eight tables, one file.

Open a free account; bulk creation opens when you move to the Business plan. The API is coming soon.