Skip to main content
POST
Record where the account first came from

Authorizations

Authorization
string
header
required

A session of the numi web app, sent as Authorization: Bearer <token>. Only the account routes take it.

Body

application/json
source
string | null

The campaign source, from the utm_source tag. It is trimmed and lower-cased, and it holds 1 to 64 characters of a-z, 0-9, dot, underscore and hyphen. Any other value is stored as null.

Example:

"hn"

medium
string | null

The campaign medium, from the utm_medium tag, under the same rule as source.

Example:

"post"

campaign
string | null

The campaign name, from the utm_campaign tag, under the same rule as source.

Example:

"launch"

referrer_host
string | null

The host name of the site that linked to numi.sh, with no scheme, path or port. It holds 1 to 253 characters of a-z, 0-9, dot and hyphen, with at least one dot. Any other value is stored as null.

Example:

"news.ycombinator.com"

landing_path
string | null

The path of the first page opened. It starts with a slash, holds at most 255 characters, and has no query or fragment. Any other value is stored as null.

Example:

"/companies/msft"

first_seen
string | null

The day of the first visit, as YYYY-MM-DD. It must be a day on the calendar from 2026-10-01 to tomorrow in UTC. Any other value is stored as null.

Example:

"2026-10-30"

Response

Whether this call recorded the attribution.

data
object
required
meta
object
required

The metadata of one success response.