Get user presence

Get the presence status for a specific user.

This endpoint is most useful for embedding data about a user's presence status in other sites (E.g. an employee directory). Full WyzePal clients like mobile/desktop apps will want to use the main presence endpoint, which returns data for all active users in the organization, instead.


See WyzePal's developer documentation for details on the data model for presence in WyzePal.

Usage examples

#!/usr/bin/env python3

import wyzepal

# Pass the path to your wyzepalrc file here.
client = wyzepal.Client(config_file="~/wyzepalrc")

# Get presence information for ""
result = client.get_user_presence('')

curl -X GET{email}/presence \


Argument Example Required Description
email "" Yes

The email address of the user whose presence you want to fetch.


Return values

  • presence: An object containing the presence details for every type of client the user has ever logged into.
    • {client_name} or aggregated: the keys for these objects are the names of the different clients where this user is logged in, like website, WyzePalDesktop, WyzePalTerminal, or WyzePalMobile. There is also an aggregated key, which matches the contents of the object that has been updated most recently. For most applications, you'll just want to look at the aggregated key.
      • timestamp: when this update was received; if the timestamp is more than a few minutes in the past, the user is offline.
      • status: either active or idle: whether the user had recently interacted with WyzePal at the time in the timestamp (this distinguishes orange vs. green dots in the WyzePal web UI; orange/idle means we don't know whether the user is actually at their computer or just left the WyzePal app open on their desktop).
      • pushable: whether the client accepts push notifications or not.
      • client: the name of the client this presence information refers to. Matches the object's key if this isn't the aggregated object.

Example response

A typical successful JSON response may look like:

    "msg": "",
    "presence": {
        "WyzePalMobile": {
            "client": "WyzePalMobile",
            "pushable": false,
            "status": "active",
            "timestamp": 1522687421
        "aggregated": {
            "client": "website",
            "status": "active",
            "timestamp": 1532697622
        "website": {
            "client": "website",
            "pushable": false,
            "status": "active",
            "timestamp": 1532697622
    "result": "success"