identify event links the current visitor (anonymous_id) to a user ID from your app, and sets traits on that user. Activity from before the call then joins the user’s history. See Identify users for the full guide.
Send identify
Fields
traits are allowed only on identify. See common fields for the envelope fields.
How traits update
- A later
identifyupdates only the keys that it sends. - A
nullvalue clears a key. - A work
emailtrait also setscompany_domain. A personal email domain setscompany_domaintonull. - You can also edit traits on the user’s profile page. The change is saved as a new
identifyevent withchanneldashboard.
How identity links work
Each event that has both ananonymous_id and a user_id links that visitor to the user. Reports then count the visitor as the user, including earlier anonymous events. If several users signed in on one shared browser, its anonymous events are not given to any of them. See core concepts.
Legacy endpoint
POST /v0/identify accepts one identify call outside a batch. The Web SDK now sends identify through /v0/events, so use this endpoint only for older integrations. See Identify API.