Skip to main content
An 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 identify updates only the keys that it sends.
  • A null value clears a key.
  • A work email trait also sets company_domain. A personal email domain sets company_domain to null.
  • You can also edit traits on the user’s profile page. The change is saved as a new identify event with channel dashboard.
Each event that has both an anonymous_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.