curl -X POST "https://api.scanova.io/qr-assets/conditional-redirect-template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"template_name": "Location-based redirect",
"data": [
{
"logic": "AND",
"conditions": [{ "field": "country", "operator": "eq", "value": "US" }],
"redirect_url": "https://example.com/us"
}
]
}'
{
"id": 3,
"template_name": "Location-based redirect",
"data": [
{
"logic": "AND",
"conditions": [{ "field": "country", "operator": "eq", "value": "US" }],
"redirect_url": "https://example.com/us"
}
],
"created": "2026-09-01T09:00:00Z",
"modified": "2026-09-01T09:00:00Z"
}
QR Assets
Create a conditional redirect template
POST /qr-assets/conditional-redirect-template/
POST
/
qr-assets
/
conditional-redirect-template
/
curl -X POST "https://api.scanova.io/qr-assets/conditional-redirect-template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"template_name": "Location-based redirect",
"data": [
{
"logic": "AND",
"conditions": [{ "field": "country", "operator": "eq", "value": "US" }],
"redirect_url": "https://example.com/us"
}
]
}'
{
"id": 3,
"template_name": "Location-based redirect",
"data": [
{
"logic": "AND",
"conditions": [{ "field": "country", "operator": "eq", "value": "US" }],
"redirect_url": "https://example.com/us"
}
],
"created": "2026-09-01T09:00:00Z",
"modified": "2026-09-01T09:00:00Z"
}
Saves a new conditional redirect template, on the Management API host (
Saving a template doesn’t attach it to any QR Code by itself — apply it to a QR Code’s conditional-redirect configuration separately.
api.scanova.io), authenticated with your raw Management API key.
POST https://api.scanova.io/qr-assets/conditional-redirect-template/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
string
required
Template name, max 100 characters.
array
required
An array of condition groups. Each group has a
logic operator (AND/OR), a conditions array of {field, operator, value} checks, and a redirect_url to send matching scans to.curl -X POST "https://api.scanova.io/qr-assets/conditional-redirect-template/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-H "Content-Type: application/json" \
-d '{
"template_name": "Location-based redirect",
"data": [
{
"logic": "AND",
"conditions": [{ "field": "country", "operator": "eq", "value": "US" }],
"redirect_url": "https://example.com/us"
}
]
}'
{
"id": 3,
"template_name": "Location-based redirect",
"data": [
{
"logic": "AND",
"conditions": [{ "field": "country", "operator": "eq", "value": "US" }],
"redirect_url": "https://example.com/us"
}
],
"created": "2026-09-01T09:00:00Z",
"modified": "2026-09-01T09:00:00Z"
}
Related
- List conditional redirect templates — see saved templates.
- Update a conditional redirect template — edit an existing one.
- 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
201 - application/json
Template created.
Was this page helpful?