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. Recognised keys are persisted as client marketing data; unknown keys are ignored. Attribution/identity keys consumed by the backend: firstTouchUrl, websiteLastPageUrl, referrerDomain (host of document.referrer), registrationDeviceType, userAgent, language, gaClientId (Google Analytics 4 client id from the _ga cookie), ymClientId (Yandex Metrica client id from the _ym_uid cookie), deviceId (mobile app device id) and adjustId (Adjust device id).

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",      "gaClientId": "GA1.2.123456789.1715000000",      "ymClientId": "1715000000123456789",      "deviceId": "550e8400-e29b-41d4-a716-446655440000",      "adjustId": "18d4a90c3f2b1e7a6c5d4e3f2a1b0c9d",      "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",          "utmContent": "hero-banner",          "utmTerm": "forex-broker",          "gclid": "Cj0KCQ...",          "gbraid": "0AAAAA...",          "wbraid": "Cj0KCQ...",          "fbclid": "IwAR0abc...",          "fbc": "fb.1.1735689600000.IwAR0abc...",          "fbp": "fb.1.1735689600000.1234567890",          "msclkid": "0a1b2c3d4e5f",          "ttclid": "E.C.P.abc123",          "yclid": "1234567890",          "bmClickId": "bm-abc123",          "ctClickId": "ct-def456",          "referrerUrl": "https://www.google.com/"        }      }    ]  }'

{}

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

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

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

{  "error": {    "message": "Access from this country is restricted",    "details": {      "ip": "203.0.113.42",      "country": "RU"    }  }}

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

Submit marketing attribution data

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

481application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`