Capture Agent Signup Attribution

POST

/agent/onboarding/attribution

• Production
• QA

Record first-touch attribution - UTM tags, ad click ids, landing page.

FIRST WRITER WINS on every key, so this is safe to call once per session and safe to retry. Nothing already captured is overwritten.

Every field is optional, which means an empty body is legal and does nothing. The response reports each destination separately (organization_persisted, contact_persisted, …) because attribution lands in more than one place and a partial write is worth knowing about - complete is the single field that says all of them took.

Authorizations

• BearerAuth

Parameters

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

Mirror of CaptureAttributionRequest.

Every field is optional and every length cap is the app’s, so a value this contract accepts is one the handler accepts too.

object

entry_point

Any of:

string

string

<= 50 characters

null

null

fbclid

Any of:

string

string

<= 255 characters

null

null

gbraid

Any of:

string

string

<= 255 characters

null

null

gclid

Any of:

string

string

<= 255 characters

null

null

landing_at

Any of:

string

string format: date-time

null

null

landing_page_url

Any of:

string

string

<= 2048 characters

null

null

signup_referrer

Any of:

string

string

<= 2048 characters

null

null

utm_campaign

Any of:

string

string

<= 255 characters

null

null

utm_content

Any of:

string

string

<= 255 characters

null

null

utm_id

Any of:

string

string

<= 255 characters

null

null

utm_medium

Any of:

string

string

<= 255 characters

null

null

utm_source

Any of:

string

string

<= 255 characters

null

null

utm_term

Any of:

string

string

<= 255 characters

null

null

wbraid

Any of:

string

string

<= 255 characters

null

null

Responses

200

Successful Response

object

data

required

An open envelope for an onboarding or discovery result.

Open on purpose. Discovery state carries a per-field coverage matrix whose field set is the product’s own onboarding questionnaire - it changes as the questionnaire does, and a pinned mirror would silently DROP a field the customer had answered. On a surface whose whole job is “what do we still not know about you”, a dropped field reads as an answered question.

object

key

additional properties

any

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

notes

Any of:

Array<string>

Array<string>

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

total_available

Any of:

integer

integer

null

null

total_is_lower_bound

Any of:

boolean

boolean

null

null

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string