curl --request POST \
--url 'https://management.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"
}
API de gestión — Carpetas y etiquetas
Crear una carpeta
POST /folder/
POST
/
folder
/
curl --request POST \
--url 'https://management.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"
}
Las carpetas agrupan códigos QR para su organización — las mismas carpetas que se muestran en la barra lateral Códigos QR > Carpetas del panel. Usa este endpoint para listar las carpetas de una cuenta o crear una nueva desde tus propios sistemas.
Ambas operaciones requieren una clave de la API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX), enviada como el valor sin procesar del encabezado Authorization. Consulta el resumen de la API de gestión para conocer los detalles de autenticación.curl --request POST \
--url 'https://management.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
requerido
Nombre de la carpeta, hasta 150 caracteres. Debe ser único para esta cuenta dentro del
folder_type indicado — un duplicado devuelve un 400 con {"name": ["Folder name already exists."]}.string
Color hexadecimal, p. ej.
#4F6BF4.string
predeterminado:"qr"
qr o page.Crear una carpeta requiere la cuota
FOLDER_MANAGEMENT de la cuenta (la gestión de carpetas es una funcionalidad de pago en algunos planes) — un 403 con "Your plan does not have folder management quota." significa que el plan no la incluye. Listar carpetas no tiene esa restricción.Relacionado
- Listar carpetas — la otra operación de este mismo endpoint.
- Gestión de etiquetas — el otro mecanismo de organización de QR, usado junto con (o en lugar de) las carpetas.
- Listar / crear códigos QR — filtra códigos QR por un ID de carpeta devuelto aquí mediante
?folder=. - Resumen de la API de gestión — el esquema de autenticación y la arquitectura de cuotas de la que forma parte este endpoint.
Autorizaciones
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. 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. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Respuesta
201
Folder created
¿Esta página le ayudó?
⌘I