Skip to main content
The Profiles API creates, reads, updates, and deletes customer profiles. A Profile is the central object in Omneo — transactions, incentives, identities, ratings, and lists all link to a profile. See Profiles for a full conceptual overview.

​
What is a profile?

Profiles are the core of customer data within Omneo. Use the Profiles API to quickly get access to core customer data such as name, gender, phone, birthday. Or even attribute data such as hair colour or jacket size. Profiles are one of the core features to the Omneo CX platform, and are used to link many other features of Omneo. Use this API to Create, Read, Update and Delete customer Profiles.

​
Profile Properties

{
   "id":"92975ecb-5264-4d31-9f2b-789fa01f4555",
   "external_id":null,
   "title":"Mr",
   "first_name":"Example",
   "last_name":"User",
   "full_name":"Example User",
   "email":"exampleuser@omneo.io",
   "gender":"male",
   "currency":"AUD",
   "joined_at":"2021-01-27 00:00:00",
   "mobile_phone":"+61404123123",
   "mobile_phone_country":61,
   "mobile_phone_national":"404123123",
   "mobile_phone_national_prefix":"0404123123",
   "mobile_phone_e164":"+61404123123",
   "secondary_phone":"+61421123123",
   "birth_year":"1989",
   "birth_month":"1",
   "birth_day":"1",
   "company":"Acme Shoe Co.",
   "occupation":"Marketing",
   "avatar_url":null,
   "preferred_location_id":null,
   "joined_location_id":null,
   "joined_location":null,
   "preferred_location":null,
   "tier_handle":null,
   "tier":null,
   "birth_date":"1989-01-01",
   "birth_days":339,
   "birth_days_past":25,
   "next_birthday":"2022-01-01",
   "identities":[
      
   ],
   "tags":[
      
   ],
   "attributes":{
      "comms":{
         "profile_id":"92975ecb-5264-4d31-9f2b-789fa01f4555",
         "email_optout":false,
         "push_optout":false,
         "sms_optout":false,
         "phone_optout":false,
         "post_optout":false,
         "email_bounced":false,
         "push_bounced":false,
         "sms_bounced":false,
         "phone_bounced":false,
         "post_bounced":false,
         "sms_promo":false,
         "push_promo":true,
         "email_promo":true,
         "phone_promo":false,
         "post_promo":false,
         "email_discover":true,
         "email_benefits":true,
         "email_reminders":true,
         "email_account":true,
         "email_bookings":true,
         "email_feedback":true,
         "email_location":false,
         "email_service":true,
         "sms_discover":false,
         "sms_benefits":false,
         "sms_reminders":true,
         "sms_account":false,
         "sms_bookings":true,
         "sms_feedback":false,
         "sms_location":false,
         "sms_service":true,
         "push_discover":true,
         "push_benefits":true,
         "push_reminders":true,
         "push_account":true,
         "push_bookings":true,
         "push_feedback":true,
         "push_location":true,
         "push_service":true,
         "phone_discover":true,
         "phone_benefits":true,
         "phone_reminders":true,
         "phone_account":true,
         "phone_bookings":true,
         "phone_feedback":true,
         "phone_location":true,
         "phone_service":true,
         "post_discover":true,
         "post_benefits":true,
         "post_reminders":true,
         "post_account":true,
         "post_bookings":true,
         "post_feedback":true,
         "post_location":true,
         "post_service":true,
         "email_verification":"not_sent",
         "sms_verification":"not_sent",
         "phone_verification":"not_sent",
         "post_verification":"not_sent",
         "terms_accepted_at":null,
         "terms_accepted_version":null,
         "created_at":"2021-01-27 22:58:01",
         "updated_at":"2021-01-27 22:58:01"
      },
      "appearance":{
         "profile_id":"92975ecb-5264-4d31-9f2b-789fa01f4555",
         "hair_colour":"Black",
         "hair_length":"Short",
         "shape_body":"Straight",
         "shape_face":null,
         "size_cup":null,
         "size_hat":null,
         "size_formal_jacket":null,
         "size_formal_jacket_length":null,
         "size_formal_shirt":null,
         "size_formal_shirt_fit":null,
         "size_formal_trouser":null,
         "size_formal_trouser_drop":null,
         "size_formal_trouser_leg":null,
         "size_jacket":null,
         "size_pant":null,
         "size_shoe":null,
         "size_type_age":null,
         "size_type_region":null,
         "size_top":null,
         "skin_type":null,
         "measurement_arm":null,
         "measurement_arm_inside":null,
         "measurement_bust":null,
         "measurement_chest":null,
         "measurement_foot_length":null,
         "measurement_head":null,
         "measurement_height":null,
         "measurement_hip":null,
         "measurement_leg_inside":null,
         "measurement_leg_outside":null,
         "measurement_neck":null,
         "measurement_neck_to_wrist":null,
         "measurement_shoulders":null,
         "measurement_waist":null,
         "measurement_weight":null,
         "created_at":"2021-01-27 22:58:01",
         "updated_at":"2021-01-27 22:58:01"
      },
      "dates": [
       	{
          "id": 1,
          "profile_id": "92a79bbb-76d1-4eec-ada9-92046381ffb6",
          "date": "2020-05-13 00:00:00",
          "is_recurring": true,
          "recurring_schedule": "yearly",
          "name": "date_name",
          "handle": "date_handle",
          "relationship": "wife",
          "description": "anniversary",
          "meta": [
              "1"
          ],
          "note": "note",
          "created_at": "2021-02-05 00:41:39",
          "updated_at": "2021-02-05 00:41:39"
        }
     	]
   },
   "statuses":[
      
   ],
   "custom_attributes":{
      "custom":{
         "example-field":"test"
      }
   },
   "address":{
      "id":9,
      "address_line_1":"asd333",
      "address_line_2":null,
      "address_line_3":null,
      "company":"Test Company",
      "latitude":null,
      "longitude":null,
      "city":"Melbourne",
      "postcode":"3002",
      "state":"victoria",
      "country":"Australia",
      "notes":null,
      "external_id":null,
      "is_default":true,
      "created_at":"2021-01-25 02:23:01",
      "updated_at":"2021-01-26 23:17:57"
   },
   "addresses":[
      {
         "id":8,
         "address_line_1":"123 Buckaby Lane",
         "address_line_2":null,
         "address_line_3":null,
         "company":null,
         "latitude":null,
         "longitude":null,
         "city":"Melbourne",
         "postcode":"3002",
         "state":"VIC",
         "country":"Australia",
         "notes":null,
         "external_id":"12341234",
         "is_default":true,
         "created_at":"2021-01-25 02:10:47",
         "updated_at":"2021-01-25 02:28:59"
      },
      {
         "id":9,
         "address_line_1":"321 Winston St",
         "address_line_2":"Georgebury Crt Level 3",
         "address_line_3":null,
         "company":"Acme Shoe Co.",
         "latitude":null,
         "longitude":null,
         "city":"Melbourne",
         "postcode":"3002",
         "state":"victoria",
         "country":"Australia",
         "notes":null,
         "external_id":null,
         "is_default":false,
         "created_at":"2021-01-25 02:23:01",
         "updated_at":"2021-01-26 23:17:57"
      }
   ],
   "created_at":"2021-01-27 22:58:01",
   "updated_at":"2021-01-27 22:58:01",
   "profile_type":"active"
}
AttributeDescription
id READ-ONLY STRINGThe profile ID (UUID V4).
external_id STRING READ-ONLYThe profile external ID. This field references the primary identities identifier. Denoted by the identity is_primary attribute.
title STRINGThe profile salutation.
first_name STRINGThe profiles first name.
last_name STRINGThe profiles last name.
full_name STRING READ-ONLYThe profiles full name. A concatenation of first_name and last_name
email STRING EMAILThe profile email. This field must be unique, and cannot exist on another profile.
gender STRINGThe profile gender. Accepted values are: * NULL - Omit the gender field * female * male * withheld * other
currency STRINGThe default currency attached to the profile Must be configured as a valid currency in Omneo
joined_at DATE-TIMEThe date the customer joined Omneo
mobile_phone STRING PHONEThe primary mobile phone number with attached country code. example format: “+61412323123” This must be unique, and cannot exist on another profile
mobile_phone_country INTEGER READ-ONLYThe country code for the provided mobile_phone example: “61”
mobile_phone_national STRING READ-ONLYThe mobile_phone number without the country code. example: “412323123”
mobile_phone_national_prefix STRING READ-ONLYThe mobile_phone_national with previx example: “0412323123”
mobile_phone_e164 STRING READ-ONLYthe E. 164 compliant mobile_phone number e.g “+61412323123”
secondary_phone STRINGThe secondary phone number for the profile.
birth_year INTEGERThe year of birth example: Birthday: 1-5-1990 the birth_year is 1990
birth_month INTEGERThe month of birth Represented as a numeric value from (1-12)
birth_day INTEGERThe day of birth
company STRINGThe company of the profile
occupation STRINGthe occupation of the profile
avatar_url STRING URLThe image used as the profile avatar
preferred_location_id INTEGERThe profiles preferred location id Represented as the id of a valid location configured in Omneo
preferred_location_external_id STRINGAn external reference for the profiles preferred location. This is usually the location reference as it sits in your primary system outside Omneo
joined_location_id INTEGERThe profiles joined location. Represented as the id of a valid location configured in Omneo
joined_location_external_id STRINGAn external reference for the profiles joined location. This is usually the location reference as it sits in your primary system outside Omneo
joined_location INTEGER READ-ONLYlocation data for the specified joined_location_id
preferred_location INTEGERlocation data for the specified preferred_location_id
tier_handle STRING READ-ONLYThe tier_handle of the profile Which displays the achieved tier the profile has reached.
tier OBJECTAccompanying tier data for the profiles tier_handle
birth_date DATE READ-ONLYYYYY-MM-DD representation of birth_year, birth_month and birth_day
birth_days INTEGER READ-ONLYThe count of days until the profiles next birthday. Calculated as the difference of days from this years birth_date until now. If this yearsbirth_date is in the past, then the following year will be used for the calculation
birth_days_past INTEGER READ-ONLYValue will return null if birth_date of this year, is in the future. If this years birth_date is in the past, birth_days_past will equal the number of days passed, since the profiles last birthday
next_birthday DATEThe date of the profiles next birthday calculated 1 year from the profiles birth_date
identities ARRAYThe profiles attached identities`
tags ARRAYThe profiles attached tags
attributes ARRAYThe profiles attached attributes
statuses STRINGAn array of the profiles attached Statuses Specify the status handle example: “influencer”, “media”, “staff” use Browse Statuses to review available statuses.
custom_attributes ARRAYCustom attributes attached to the profile
address STRINGThe default address against the profile.
addresses ARRAYAll addresses against the profile.
created_at DATE-TIME READ-ONLYThe UTC date & time the Profile record was created in ISO 8601 format.
updated_at DATE-TIME READ-ONLYThe UTC date & time the Profile record was last updated in ISO 8601 format.
profile_type STRINGAccepted values: * temporary * pending * active * deleted

​
Event Context

The profile context available in webhooks and targets. 
{
   "id":"92975ecb-5264-4d31-9f2b-789fa01f4555",
   "external_id":null,
   "title":"Mr",
   "first_name":"Example",
   "last_name":"User",
   "full_name":"Example User",
   "email":"exampleuser@omneo.io",
   "gender":"male",
   "currency":"AUD",
   "joined_at":"2021-01-27 00:00:00",
   "mobile_phone":"+61404123123",
   "mobile_phone_country":61,
   "mobile_phone_national":"404123123",
   "mobile_phone_national_prefix":"0404123123",
   "mobile_phone_e164":"+61404123123",
   "secondary_phone":"+61421123123",
   "birth_year":"1989",
   "birth_month":"1",
   "birth_day":"1",
   "company":"Acme Shoe Co.",
   "occupation":"Marketing",
   "avatar_url":null,
   "preferred_location_id":null,
   "joined_location_id":null,
   "joined_location":null,
   "preferred_location":null,
   "tier_handle":null,
   "tier":null,
   "birth_date":"1989-01-01",
   "birth_days":339,
   "birth_days_past":25,
   "next_birthday":"2022-01-01",
   "tier_handle" : "tier_handle",
   "reward_balance" : 131, 
   "point_balance" : 100, 
   "combined_balance_dollars" : 231, 
   "aggregations" : {}, // Aggregation Context
   "is_completed" : true,
   "tier" : {}, // Tier Context
   "identities":[], // Identities Context
   "tags":[
     {
       "created_at" : "2021-04-23 02:04:38", 
       "handle" : "tag1",
       "id" : 11, 
       "updated_at" "2021-04-23 02:04:38"
     },
      {
       "created_at" : "2021-04-23 02:04:38", 
       "handle" : "tag2",
       "id" : 12, 
       "updated_at" "2021-04-23 02:04:38"
     }
   ],
   "flattened_tags" : ['tag1', 'tag2'],
   "flattened_statuses" : ['status1', 'status2'],
   "attributes":{
      "comms":{}, // Comms Context
      "appearance":{}, // Appearence Context
      "dates": [] // Dates Context
   },
   "statuses":[
     {
       "created_at" : "2021-04-23 02:04:38", 
       "handle" : "status1",
       "id" : 110, 
       "updated_at" "2021-04-23 02:04:38"
     },
    {
     "created_at" : "2021-04-23 02:04:38", 
       "handle" : "status2",
        "id" : 111, 
        "updated_at" "2021-04-23 02:04:38"
    }
   ],
   "custom_attributes":{
      "custom":{
         "example-field":"test"
      }
   },
   "address":{}, //Address Context
   "addresses":[], // Addresses Context
   "created_at":"2021-01-27 22:58:01",
   "updated_at":"2021-01-27 22:58:01",
   "profile_type":"active"
}