GuidesSupport

Identify Visitors

Define visitor properties on an existing visitor or create a new visitor. Note: This does not fire an event. If you want to fire an event, use the track method and include properties for the visitor.

POST
/identify

Request Body

The payload to identify a visitor

tokenstring

The token for your Ours Privacy Source. You can find this in the Ours dashboard.

Length1 <= length <= 250
userId?string|null

The Ours user id stored in local storage and cookies on your web properties. If userId is included in the request, we do not lookup the user by email or externalId.

Length1 <= length <= 400
externalId?string|null

The externalId (the ID in your system) of a user. We will associate this event with the user or create a user. If included in the request, email lookup is ignored.

Length1 <= length <= 400
email?string|null

The email address of a user. We will associate this event with the user or create a user. Used for lookup if externalId and userId are not included in the request.

Length1 <= length <= 1000
userProperties

User properties to associate with this user. The existing user properties will be updated. And all future events will have these properties associated with them.

defaultProperties?|null

These properties are used throughout the Ours app to pass known values onto destinations

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.oursprivacy.com/api/v1/identify" \  -H "Content-Type: application/json" \  -d '{    "token": "string",    "userProperties": {}  }'
{
  "success": true
}
{
  "success": false
}
{
  "success": false
}
{
  "success": false
}
{
  "success": false
}

How is this guide?

Track Events

Next Page