Submit marketing attribution data

After the first successful authentication, the front-end submits captured marketing attribution data (UTM parameters, click IDs, device context, and the full journey of marketing touches) for the authenticated client. The endpoint is idempotent on (clientId, sessionId): repeated calls from the same browser do not duplicate data.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

sessionId*uuid

Client-generated UUID identifying the attribution session. Used by the backend to deduplicate repeated submissions from the same browser.

Formatuuid

firstSeenAt*string

ISO 8601 timestamp of the very first page load in this attribution session.

Formatdate-time

attributes*

Session-level context captured once at first visit (device, locale, first touch URL, etc.). Keys are camelCase, values are strings.

touches*array<>

Ordered list of marketing touches recorded during the journey. Each touch holds a captured timestamp and its own attribute map.

Response Body

`application/json`

curl -X POST "https://example.com/api/v2/my/signup-context" \  -H "Content-Type: application/json" \  -d '{    "sessionId": "36f59381-5b54-48bd-a0c7-3b908c476732",    "firstSeenAt": "2026-05-18T10:11:12+00:00",    "attributes": {      "firstTouchUrl": "https://b2prime.com/?utm_source=google",      "registrationDeviceType": "desktop",      "websiteLastPageUrl": "https://b2prime.com/pricing",      "referrerDomain": "google.com",      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",      "platform": "macOS",      "language": "en-US",      "timezone": "Europe/Moscow",      "screenResolution": "2560x1440",      "hardwareConcurrency": "10"    },    "touches": [      {        "capturedAt": "2026-05-18T10:11:12+00:00",        "attributes": {          "landingUrl": "https://b2prime.com/?utm_source=google&utm_campaign=brand",          "utmSource": "google",          "utmMedium": "cpc",          "utmCampaign": "brand",          "gclid": "Cj0KCQ...",          "gaClientId": "GA1.2.123456789.1715000000",          "referrerUrl": "https://www.google.com/",          "referrerDomain": "google.com"        }      }    ]  }'

{}

{  "error": {    "message": "Bad Request",    "details": [      {        "issue": "The selected value is invalid.",        "field": "parameter"      }    ]  }}

{  "error": {    "message": "Unauthorized"  }}

{  "error": {    "message": "Too Many Requests"  }}

{  "error": {    "message": "Service Unavailable"  }}

Submit marketing attribution data

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`