curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Folders & Tags
Create a custom tag
POST /tag/custom/
POST
/
tag
/
custom
/
curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Creates a custom tag for the requesting account on the Management API host (
api.scanova.io), authenticated with your raw Management API key.
POST https://api.scanova.io/tag/custom/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
required
Tag name, up to 50 characters. Rejected if it contains
< or > (blocks e.g. <script> payloads).curl -X POST "https://api.scanova.io/tag/custom/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{ "tag": "vip" }'
{ "tag": "vip" }
Tags are shared by name, ownership isn’t
The underlying tag name (vip) is a shared/global value across the whole system — creating a custom tag either reuses an existing tag with that name or creates a new one. What’s per-account is the ownership record: this call fails with 400 if this account already has a custom tag with that name, even if the tag name itself is already used elsewhere (e.g. attached to another account’s QR Codes).
Related
- List your custom tags — see what this call adds.
- List tags — the account’s full tag directory.
- 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.
Body
application/json
Tag name. Rejected if it contains < or >.
Maximum string length:
50Response
Custom tag created.
Was this page helpful?