Sign in
Acquisition Sessions

Start or resume an acquisition funnel session

Creates a new acquisition session for the given funnel. If an in-progress session for the same lead and funnel already exists, returns it instead of creating a duplicate (idempotent).

post/v1/acquisition/sessions

Request body

funnelIdstring required

Stable funnel slug (e.g. "quiz-3-v2-adaptive")

firebaseUidstring

Firebase Auth UID (anonymous or registered). When present, we attach this session to the existing lead with the same UID.

localestring

Optional locale override. Defaults to "en".

experimentsobject

Map of experimentId → assignment captured at funnel entry

deviceType'mobile' | 'tablet' | 'desktop'
userAgentstring
countrystring
ipAddressstring
amplitudeDeviceIdstring
facebookPixelIdstring
tiktokPixelIdstring

Response

createdboolean required

True when a brand-new session was created; false when an existing in-progress session was returned.

leadIsCustomerboolean required

True if the lead is a known paying customer. The funnel should redirect to the app instead of continuing.

Changes

No recorded changes to this endpoint across all 1 revision of this API.