Skip to main content
POST
Identify a user

Authorizations

Authorization
string
header
required

Your project's publishable key (pk_pub_…). Safe to expose in the browser — it identifies the project and is rate-limited, not secret.

Body

application/json
userId
string
required

Your product's id for this user.

Maximum string length: 256
Example:

"user_123"

traits
object

User traits (max 4 KB serialized), shallow-merged into the existing profile. $-prefixed keys are reserved for auto-collected context ($browser, $os, $timezone, $country, …).

Example:

Response

Success.

ok
boolean
required