curl --request POST \
--url 'https://api.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Holiday Campaign",
"color": "#22C55E"
}'
{
"id": 42,
"name": "Holiday Campaign",
"color": "#22C55E",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-08-16T20:40:02.115000+05:30",
"updated": "2026-08-16T20:40:02.115000+05:30"
}
Folders & Tags
Create a folder
POST /folder/
POST
/
folder
/
curl --request POST \
--url 'https://api.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Holiday Campaign",
"color": "#22C55E"
}'
{
"id": 42,
"name": "Holiday Campaign",
"color": "#22C55E",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-08-16T20:40:02.115000+05:30",
"updated": "2026-08-16T20:40:02.115000+05:30"
}
Folders group QR Codes for organization — the same folders shown in the dashboard’s QR Codes > Folders sidebar. Use this endpoint to list an account’s folders or create a new one from your own systems.
Both operations require an API key with
MANAGEMENT_API (or MANAGEMENT_API_SANDBOX) quota, sent as the raw Authorization header value. See the API overview for authentication details.curl --request POST \
--url 'https://api.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Holiday Campaign",
"color": "#22C55E"
}'
{
"id": 42,
"name": "Holiday Campaign",
"color": "#22C55E",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-08-16T20:40:02.115000+05:30",
"updated": "2026-08-16T20:40:02.115000+05:30"
}
string
required
Folder name, up to 150 characters. Must be unique for this account within the given
folder_type — a duplicate returns a 400 with {"name": ["Folder name already exists."]}.string
Hex color, e.g.
#4F6BF4.string
default:"qr"
qr or page.Creating a folder requires the account’s
FOLDER_MANAGEMENT quota (folder-management is a paid capability on some plans) — a 403 with "Your plan does not have folder management quota." means the plan doesn’t include it. Listing folders has no such gate.Related
- List folders — the other operation on this same endpoint.
- Update a folder — rename or recolor an existing one.
- Move QR Codes into a folder — assign QR Codes to the folder you just created.
- Tag management — the other QR-organization mechanism, used alongside (or instead of) folders.
- List / create QR Codes — filter QR Codes by a folder ID returned here via
?folder=. - API overview — the auth scheme and quota architecture this endpoint is part of.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Response
201
Folder created
Was this page helpful?