A shopper started a quiz

POST

Once per session, on the shopper’s first move forward or first collected answer. Carries the start only: no answers and no identities.

Request Body^required

Media typeapplication/json

WebhookEvent_WebhookSessionStarted_

object

api_version

Api Version

The payload version

string

default: v1

Allowed value: v1

created

required

Created

When the event happened

string format: date-time

data

required

WebhookData_WebhookSessionStarted_

The event’s object

object

object

required

WebhookSessionStarted

The topic’s object

object

arm_id

Any of:

string

string

/^arm_[0-9a-f]{32}$/

null

null

channel

required

Channel

How the shopper arrived: direct | organic_search | paid_search | organic_social | paid_social | email | sms | affiliate | display | paid_other | referral | ai_assistant | other | shared_results

string

country

required

Any of:

string

string

null

null

device

required

WebhookDevice

The device as parsed from the session’s user agent when it opened

object

browser

required

Any of:

string

string

null

null

browser_version

required

Any of:

string

string

null

null

class

required

Class

Mobile | tablet | desktop

string

family

required

Any of:

string

string

null

null

model

required

Any of:

string

string

null

null

os

required

Any of:

string

string

null

null

os_version

required

Any of:

string

string

null

null

vendor

required

Any of:

string

string

null

null

experiment_id

Any of:

string

string

/^expt_[0-9a-f]{32}$/

null

null

id

required

Id

The session’s id, the same session_id the profiles API shows

string

/^sess_[0-9a-f]{32}$/

page_url

required

Any of:

string

string

null

null

quiz_id

required

Quiz Id

The quiz the session ran

string

/^quiz_[0-9a-f]{32}$/

quiz_name

required

Any of:

string

string

null

null

region

required

Any of:

string

string

null

null

source_kind

required

Any of:

string

string

null

null

source_session_id

required

Any of:

string

string

/^sess_[0-9a-f]{32}$/

null

null

started_at

required

Started At

When the session opened

string format: date-time

utm_campaign

required

Any of:

string

string

null

null

utm_content

required

Any of:

string

string

null

null

utm_medium

required

Any of:

string

string

null

null

utm_source

required

Any of:

string

string

null

null

utm_term

required

Any of:

string

string

null

null

version_id

required

Any of:

string

string

/^ver_[0-9a-f]{32}$/

null

null

version_number

required

Any of:

integer

integer

null

null

visitor_id

required

Visitor Id

The shopper’s browser: the persistent visitor, or a visitor of this session only until analytics consent is given

string

/^vis_[0-9a-f]{32}$/

id

required

Id

The event id, also sent as the webhook-id header; deduplicate on it

string

/^evt_[0-9a-f]{32}$/

type

required

Type

The topic: quiz.started | quiz.finished | quiz.abandoned | identity.captured | quiz.published | experiment.started | experiment.ended | profile.created | profile.updated | export.completed | webhook.endpoint.disabled | ping

string

Responses

200

Any 2xx within 10 seconds acknowledges the event

4XX

410 ends the delivery and disables the endpoint; any other 4xx but 408 and 429 ends it

5XX

Retried, as are 408, 429, a timeout and a network error: seven retries over about 28 hours, then the delivery is dead