Skip to main content

Node — Identify

Identify a user and set their properties with signal.identify(options). Sends an $identify event. Pass sessionId and windowId from request headers when you want to correlate with the client session.

identify(options)

OptionTypeRequiredDescription
distinctIdstringyesUser identifier
propertiesUserTraitsnoUser properties to set
sessionIdstringnoFrom header for client correlation
windowIdstringnoFrom header for client correlation

Example

const { sessionId, windowId, distinctId } = getSessionInfo(req);

signal.identify({
  distinctId: 'user_123',
  properties: { email: 'user@example.com', name: 'Jane' },
  sessionId,
  windowId,
});

See also