curl -X POST "https://api.scanova.io/qr-assets/template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Poster",
"template_type": "P",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "data:image/png;base64,iVBORw0KGgo..."
}'
{
"id": 12,
"name": "Summer Poster",
"template_id": "a1b2c3d4e5f6",
"template_type": "P",
"template_type_display": "Poster",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "https://cdn.scanova.io/upload/images/42/template-foo.png"
}
QR Assets
Create a QR Code design template
POST /qr-assets/template/
POST
/
qr-assets
/
template
/
curl -X POST "https://api.scanova.io/qr-assets/template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Poster",
"template_type": "P",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "data:image/png;base64,iVBORw0KGgo..."
}'
{
"id": 12,
"name": "Summer Poster",
"template_id": "a1b2c3d4e5f6",
"template_type": "P",
"template_type_display": "Poster",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "https://cdn.scanova.io/upload/images/42/template-foo.png"
}
Saves a new QR Code design template, on the Management API host (
api.scanova.io), authenticated with your raw Management API key.
POST https://api.scanova.io/qr-assets/template/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
required
Template name, max 150 characters.
string
default:"N"
"P" (Poster) or "N" (Normal). Create-only — see the note below.string
Design pattern data, typically JSON encoded as a string (dot style, eye shape, colors, logo).
string
A base64-encoded image, or omit to save pattern data only.
curl -X POST "https://api.scanova.io/qr-assets/template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"name": "Summer Poster",
"template_type": "P",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "data:image/png;base64,iVBORw0KGgo..."
}'
{
"id": 12,
"name": "Summer Poster",
"template_id": "a1b2c3d4e5f6",
"template_type": "P",
"template_type_display": "Poster",
"pattern_info": "{\"dotStyle\":\"round\"}",
"image": "https://cdn.scanova.io/upload/images/42/template-foo.png"
}
template_id is server-generated and unique — you never set it. 403 if the account lacks the SAVE_DESIGN_TEMPLATE quota, has an inactive plan, or lacks QR_CODE_CAN_ADD/QR_CODE_CAN_EDIT permission (relevant for shared users with restricted roles).
Related
- List QR Code design templates — see saved templates.
- Update a QR Code design template — edit an existing one;
template_typecan’t be changed here. - Management API overview — the auth scheme and quota rules that apply to this endpoint.
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: 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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Response
Template created.
Was this page helpful?