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

  • Base URL
    https://api.miaai.chat (the document declares no server; this is the origin it was published from)
  • URL
    https://api.miaai.chat/v1/acquisition/sessions
  • Auth
    HTTP bearer

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 operation across all 1 revision of this API.