Users

The users api is the best way to retrieve data about individual users of your app. Users can be read or deleted using this endpoint.

Attribute	Type	Description
id	string	The Taplytics id for this user
created_at	timestamp	The date and time this user was first seen
user_id	string	The custom user_id that you defined for this user
email	string	The email address you have defined for this user
first_name	string	The first name you have defined for this user
last_name	string	The last name you have defined for this user
name	string	The full name you have defined for the user
custom_data	object	The custom data that you have defined for this user
last_seen_ip	string	The last seen ip address of this user
location	object	The last location info for this user
session_count	integer	The number of sessions this user has been a part of

User

A single User object with all its details, can be accessed via the appUser ID, Email or your custom User ID. If an email or custom User ID is provided in the URL parameters, the ID field can be omitted.

Creating the user: requires any of the following (user_id, email)
Updating the user: requires any of the following (id, user_id, email)

Note:

User creation will not show up instantly in the dashboard until the user that's created sends events that the dashboard tracks through an SDK.
The custom data can only be reliably kept with no more than one level of nesting, if the user currently has a custom data object and one is posted, the two will be merged.
While the custom data is appended immediately to the user, updating the custom data segmentation filter will have a requirement of > 100 events sent on a prod device or a couple of events sent on a dev device in order for the new custom data filter to appear.

Model

(application/json; charset=utf-8)

Body

{
    "id": "548223f2c7036020742ff21c",
    "created_at": "2015-01-06T03:51:57+00:00",
    "user_id": "42",
    "email": "[email protected]",
    "first_name": "Jonathan",
    "last_name": "Norris",
    "custom_data": {
        "occupation": "Bug Fixer",
        "favourite_color": "Chartreuse",
        "favourite movie": "You Don't Mess With The Zohan"
    },
    "last_seen_ip": "123.123.123.123",
    "location": {
        "city_name": "San Francisco",
        "continent_code": "NA",
        "country_code": "USA",
        "country_name": "United States",
        "latitude": 37.7749300,
        "longitude": -122.4194200,
        "postal_code": null,
        "region_name": "San Francisco",
        "timezone": "Europe/San Francisco"
    },
    "session_count": 16,
    "gender": "male"
}