Agents

Capture Agent Signup Attribution

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.

post/agent/onboarding/attribution

Request

Base URL: https://be.graph8.com/api/v1
URL: https://be.graph8.com/api/v1/agent/onboarding/attribution
Auth: HTTP bearer

Headers

Authorizationstring nullable

X-Target-Org-Idstring nullable

Request body

entry_pointstring nullable

Signup entry-point slug.

utm_sourcestring nullable

utm_mediumstring nullable

utm_campaignstring nullable

utm_termstring nullable

utm_contentstring nullable

utm_idstring nullable

gclidstring nullable

wbraidstring nullable

gbraidstring nullable

fbclidstring nullable

landing_page_urlstring nullable

landing_atstring date-time nullable

signup_referrerstring nullable

Response

Successful Response

dataOnboardingPayload 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.

Changes

No recorded changes to this operation across all 2 revisions of this API.