Record where the caller's account came from

Full sessions only. The login app posts the first-touch sign-up source once, right after a new account's first session. The first post within a day of the account's creation is kept; later posts and posts for older accounts are ignored. Values that aren't plain campaign tags, known tool names, a hostname or a path are dropped: a referrer is cut to its host and a landing page to the first two segments of its path, so nothing that identifies a person and no capability link is stored. The body is limited to 4 KB.

Authorization

bearer

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

A first-touch sign-up source. Every field is optional; empty or invalid values are stored as empty.

utm_source?string

Lengthlength <= 100

utm_medium?string

Lengthlength <= 100

utm_campaign?string

Lengthlength <= 100

utm_content?string

Lengthlength <= 100

utm_term?string

Lengthlength <= 100

ref?string

e.g. "badge"

Lengthlength <= 100

badge_tool?string

The tool whose "Made with Easerix" badge was clicked

badge_page?string

The id of the page that showed the badge

Lengthlength <= 100

referrer_host?string

Host only; a full URL is cut to its host

landing_path?string

Path only: a query or fragment is cut off, only the first two segments are kept, and a path holding @ or % is dropped

Lengthlength <= 200

first_tool?string

The tool the visitor was heading to (notes, forms, sign, links, tasks, canvas, crm, croncrunch, sites, notary, pro, hub)

Response Body

`application/json`

curl -X POST "https://example.com/v1/me/attribution" \  -H "Content-Type: application/json" \  -d '{}'

Empty

Record where the caller's account came from

Authorization

Request Body

Response Body

204

400application/json

401application/json

403application/json

`application/json`

`application/json`

`application/json`