curl --request POST \
--url 'https://api.scanova.io/web-tracking/sites/7/funnels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Poster to purchase",
"domains": ["example.com"],
"definition": [
{"event_type": "scan"},
{"event_type": "page_view", "path": "/products"},
{"event_type": "purchase"}
]
}'
{
"id": 4,
"site": {
"id": 7,
"site_id": "aZ3kP9...64-char-random-id",
"name": "Marketing site",
"is_active": true,
"verified_on": "2026-09-05T09:00:00+05:30",
"is_verified": true,
"created": "2026-09-01T10:00:00+05:30",
"modified": "2026-09-09T08:10:00+05:30"
},
"name": "Poster to purchase",
"domains": ["example.com"],
"definition": [
{"event_type": "scan"},
{"event_type": "page_view", "path": "/products"},
{"event_type": "purchase"}
],
"created": "2026-09-09T08:20:00+05:30",
"modified": "2026-09-09T08:20:00+05:30"
}
Web Tracking
List / create funnels
GET, POST /web-tracking/sites//funnels/
GET
/
web-tracking
/
sites
/
{site_id}
/
funnels
/
curl --request POST \
--url 'https://api.scanova.io/web-tracking/sites/7/funnels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Poster to purchase",
"domains": ["example.com"],
"definition": [
{"event_type": "scan"},
{"event_type": "page_view", "path": "/products"},
{"event_type": "purchase"}
]
}'
{
"id": 4,
"site": {
"id": 7,
"site_id": "aZ3kP9...64-char-random-id",
"name": "Marketing site",
"is_active": true,
"verified_on": "2026-09-05T09:00:00+05:30",
"is_verified": true,
"created": "2026-09-01T10:00:00+05:30",
"modified": "2026-09-09T08:10:00+05:30"
},
"name": "Poster to purchase",
"domains": ["example.com"],
"definition": [
{"event_type": "scan"},
{"event_type": "page_view", "path": "/products"},
{"event_type": "purchase"}
],
"created": "2026-09-09T08:20:00+05:30",
"modified": "2026-09-09T08:20:00+05:30"
}
A funnel defines an ordered sequence of events (e.g. scan → page view → purchase) that Conversion Tracking reports evaluate visitors against.
Results are ordered by
Requires the account’s
CONVERSION_TRACKING quota.integer
required
Tracking site ID.
string
required
Funnel display name.
array
Domains this funnel applies to (a subset of, or matching, the site’s own registered domains).
array
required
Ordered list of funnel steps, each an object with at least an
event_type.event_type: "scan" may only appear as the first step — any later step using it returns 400 with {"definition": ["Scan can only be used as the first funnel step."]}.curl --request POST \
--url 'https://api.scanova.io/web-tracking/sites/7/funnels/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Poster to purchase",
"domains": ["example.com"],
"definition": [
{"event_type": "scan"},
{"event_type": "page_view", "path": "/products"},
{"event_type": "purchase"}
]
}'
{
"id": 4,
"site": {
"id": 7,
"site_id": "aZ3kP9...64-char-random-id",
"name": "Marketing site",
"is_active": true,
"verified_on": "2026-09-05T09:00:00+05:30",
"is_verified": true,
"created": "2026-09-01T10:00:00+05:30",
"modified": "2026-09-09T08:10:00+05:30"
},
"name": "Poster to purchase",
"domains": ["example.com"],
"definition": [
{"event_type": "scan"},
{"event_type": "page_view", "path": "/products"},
{"event_type": "purchase"}
],
"created": "2026-09-09T08:20:00+05:30",
"modified": "2026-09-09T08:20:00+05:30"
}
name, then most-recently-modified.
Related
- Retrieve / update / delete a funnel
- Management 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: 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.
Path Parameters
Response
Funnels for this site, ordered by name then most-recently-modified.
Was this page helpful?