Sessions

// access
client.sessions

The sessions spine — identify people, start/refresh journey sessions.

Events, logs, errors, surveys and replay all correlate into a session, so this is usually the first call a backend makes for a request.

SessionsCopy Anchor Link

Extends Resource.

identify()Copy Anchor Link

def identify(distinct_id, *, email=None, name=None, phone=None, traits=None) -> Dict[str, Any]

Create or update the person behind distinct_id.

client.sessions.identify("user_123", email="a@b.com", traits={"plan": "pro"})

Parameters

Returns Dict[str, Any]

track()Copy Anchor Link

def track(*, distinct_id=None, email=None, name=None, traits=None, device_key=None, session_key=None, browser=None, app_version=None, country=None, entry_url=None, os_type=None, os_version=None) -> Dict[str, Any]

Start or refresh the active session; returns the server payload (including sessionId).

Omitted identity fields fall back to the ambient nexus.context and then to the client config.

Parameters

Returns Dict[str, Any]