Create many codes

Up to the plan's batch size per call (see limits.bulkBatch on GET /me), all into one folder, all or nothing. Ten batches per ten minutes per key.

Authorization

apiKey

AuthorizationBearer <token>

An API key from Settings, Developers: Authorization: Bearer kc_live_...

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

rows*array<>

One code per row. GS1 rows carry gs1; a batch is all links or all GS1.

Items1 <= items <= 1000

templateId?string

scanHost?string

Branded scan host for every code in the batch.

Lengthlength <= 253

folderId?string

Existing folder for the whole batch. Exactly one of folderId / newFolderName.

newFolderName?string

Create this folder at the root and file the batch in it.

Length1 <= length <= 120

Response Body

`application/json`

curl -X POST "https://example.com/codes/bulk" \  -H "Content-Type: application/json" \  -d '{    "rows": [      {        "name": "string",        "url": "http://example.com"      }    ]  }'

{  "folderId": "string",  "created": 0,  "codes": [    {      "id": "string",      "shortCode": "string",      "name": "string"    }  ]}

Authorization

Request Body

Response Body

201application/json

400application/json

403application/json

409application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`