Records the first touch (write-once) and the owner's answer or skip.

PUT

/account/attribution

curl --request PUT \
  --url https://api.siteqwality.com/account/attribution \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "first_touch": { "source": "example", "medium": "example", "campaign": "example", "referrer_host": "example", "landing_host": "example", "landing_path": "example", "touched_at": "example" }, "self_reported": { "channel": "example", "detail": "example" }, "skipped": true }'

• Production

Authorizations

• bearer_auth

Request Body ^required

Media type application/json

Every field is optional and unknown fields are ignored. Text is trimmed, stripped of control characters and cut to its cap; an empty value is absent.

object

first_touch

One of:

object

Write-once: fills only the columns that are still empty.

object

source

At most 64 characters, as are medium and campaign.

string | null

medium

string | null

campaign

string | null

referrer_host

Host only, at most 100 characters, as is landing_host.

string | null

landing_host

string | null

landing_path

Path only, no query or hash, at most 160 characters.

string | null

touched_at

RFC 3339. Dropped when unparseable, over 120 days old or more than a day ahead.

string | null

null

null

self_reported

One of:

object

Replaces an earlier answer, including a skip.

object

channel

One of search, ai_assistant, community, social, referral, content, review_site, github_mcp, other. A skip goes through skipped.

string | null

detail

Free text, at most 200 characters.

string | null

null

null

skipped

Records a skip unless an answer exists. Not combinable with self_reported.

boolean | null

Example ^generated

{
  "first_touch": {
    "source": "example",
    "medium": "example",
    "campaign": "example",
    "referrer_host": "example",
    "landing_host": "example",
    "landing_path": "example",
    "touched_at": "example"
  },
  "self_reported": {
    "channel": "example",
    "detail": "example"
  },
  "skipped": true
}

Responses

204

Recorded

400

Invalid request body

401

Missing or invalid authentication

403

Only the owner of an account at most 14 days old may record this

500

Internal server error