User Profile

The User Profile object

{
  "id": "AVqvOB58Fg6nZfQ0ZqXt",
  "name": "John Doe",
  "given_name": "John",
  "family_name": "Doe",
  "username": "jdoe",
  "nickname": "Johnny",
  "birthdate": "1983-11-13",
  "age": 33,
  "email": "john.doe@example.com",
  "email_verified": true,
  "emails": {
    "verified": [
      "john.doe@example.com"
    ],
    "unverified": [
      "other@example.com"
    ]
  },
  "gender": "male",
  "phone_number": "+33612345678",
  "phone_number_verified": false,
  "picture": "https://graph.facebook.com/10154500298019865/picture",
  "profile": "https://www.facebook.com/app_scoped_user_id/10154500298019865/",
  "addresses": [
    {
      "id": 0,
      "default": true,
      "address_type": "billing",
      "street_address": "10 rue Chaptal",
      "locality": "Paris",
      "postal_code": "75009",
      "region": "Île-de-France",
      "country": "France",
      "recipient": "Matthieu Winoc",
      "phone_number": "0723538943"
    }
  ],
  "likes_count": 67,
  "created_at": "2017-03-08T18:39:35.026Z",
  "updated_at": "2018-08-12T12:54:09.631Z",
  "first_login": "2017-03-08T18:39:35.026Z",
  "last_login": "2018-08-12T12:54:09.631Z",
  "logins_count": 53,
  "origins": [
    "website",
    "game"
  ],
  "last_login_type": "facebook",
  "custom_fields": {
    "loyalty_card_number": "19872359235"
  },
  "consents": {
    "newsletter": {
        "consent_type": "opt-in"
        "granted": true,
        "date": "2018-05-25T15:41:09.671Z"
      }
  },
  "facebook_ids_for_pages": [
    {
      "user_id": "649145309042062",
      "page_id": "931332113682072"
    }
  ],
  "external_id": "2977460"
}

User Profile fields

Name Scope required Description

id

none

ReachFive user ID.

name

profile

Full user name

given_name

profile

Given name(s) or first name(s)

family_name

profile

Surname(s) or last name(s)

username

profile

Username

middle_name

profile

Middle name(s)

nickname

profile

Casual name that may or may not be the same as the given_name

profile

profile

URL of one of the user’s profile page (usually a social provider’s page).

picture

profile

URL of one of the user’s profile picture. This URL refers to an image file (for example, a PNG, JPEG, or GIF image file).

email

email

User’s primary email address.

email_verified

email

Boolean. true if the user’s email address has been verified.

email

Emails object. User’s email addresses.

phone_number

phone

User’s primary phone number.

phone_number_verified

phone

Boolean. true if the user’s phone number has been verified.

gender

profile

User’s gender. Allowed values are female , male, or other.

birthdate

profile

User’s birthdate, represented as an ISO 8601 YYYY-MM-DD format.

age

profile

Integer. User’s age computed from birth date.

company

profile

User’s company name.

likes_count

profile

Integer. Number of facebook pages liked by the user.

address

Array of Address objects. User’s postal addresses.

profile

Array of Identity objects. List of user’s provider identities.

has_password

profile

Boolean. true if the user has a password

created_at

profile

Date when the user was created

updated_at

profile

Date when the user was last updated

first_login

profile

Date of the user’s first login

last_login

profile

Date of the user’s last login

logins_count

profile

Integer. Number of logins for this user.

last_login_type

profile

Name of the authentication type used when user last logged in. e.g. facebook, google, password.

origins

profile

Array of strings. List of origins.

custom_fields

Custom

Object. User’s custom fields.

profile

Users consents. Object containing a series of fields: for each consent key, a Consent object.

profile

Array of Friend objects. List of user’s friends also linked to the same ReachFive account.

profile

Array of Facebook Page objects. List of page scoped facebook user ids.

lite_only

profile

Boolean. true if the profile is LITE only.

external_id

profile

The unique identifier of the profile in your systems or Single Customer View.

The external ID is usually your internal unified customer profile ID, before you integrate with ReachFive.

Loading this information into ReachFive is useful to progressively update your systems with the ReachFive profile ID, or, if you must continue to use this ID for specific purposes.

Emails object

Name Description

verified

Array of strings. List of verified user’s email addresses.

unverified

Array of strings. List of unverified email addresses.

Addresses object

Name Description

id

ID of the address

title

Title of the address

default

Boolean. true if the address is the default postal address of the user. Only a single address can be the default address.

address_type

Type of the address. Allowed values are delivery or billing .

street_address

Full street address component, which may include house number, street name, and extended street address information separated by new lines.

locality

City or locality.

region

State, province, prefecture, or region.

postal_code

Zip code or postal code.

country

Country name.

delivery_note

Additional note from the user for the delivery.

recipient

Name of the recipient located at these address.

company

Name of the company located at these address.

phone_number

Phone number of the contact point at these address (no format validation is required).

Identities object

Name Description

id

The unique ID. This is created from a concatenation of the provider, :, and the user_id. For example: facebook:123456789.

provider

Name of the connected provider for this identity, in lowercase letters (facebook, google, etc.)

user_id

User’s unique identifier of the provider.

created_at

Date when this identity was linked to the profile.

updated_at

Date when this identity was last updated.

Consents object

Name Description

consent_type

Consents type: opt-in or opt-out.

granted

Boolean. Whether the consent has been granted or not.

date

Consent date

Friends object

Name Description

id

ReachFive identifier.

name

Full name.

given_name

Given name

family_name

Family name

gender

Gender

Facebook page object fields

Name Description

user_id

Page scoped user identifier.

page_id

Facebook page identifier.

Custom fields

The required scope must be declared when creating the custom fields.