Retrieve group profiles by profile id

Sections

API explorerChangelog

Theme switcher

Overview

Getting started with MyPreferences 3.0 API is easy.  Before we dive in, let's take a few moments to learn about the authorization schemes and API categorization based on the core framework of MyPreferences. 

Using API's

See the Authorization section to view the authorization schemes required to interact with the MyPreferences API. 

The MyPreferences API is a RESTful API that conforms to the constraints of a software architectural style called REST (Representational State Transfer). The API makes the configuration objects and data available as resources represented by unique URLs, also referred as endpoints.

In general, the API supports the following request methods:

GET: To retrieve a resource

POST: To create a new resource

Note: Within the Data API collection, the Update Profile method is accessible through a POST request to efficiently update a profile. This purpose-built design empowers client-facing apps to modify profiles directly, eliminating the need to retrieve them beforehand.

PUT: To update (overwrite) an existing resource

PATCH: To perform partial updates to an existing resource

DELETE: To delete a resource

API Categorization

The API's are categorized into three sets with distinct functionalities based on the application's core framework: Experiences, Data, and Connectivity.

Data Categorization

In MyPreferences, the data is organized in three main areas: Profiles, Preferences and Consents.

Profiles

In the Profiles area, you can store various data points including names, contact information, group affiliations, and a wide range of demographic and psychographic details.

Additionally, you have the flexibility to store multiple Alternate IDs, such as system and device identifiers, to uniquely identify individuals and devices within your enterprise ecosystem. This area also encompasses the storage of consents not linked to specific contact elements or preferences, along with Tags, Custom Fields, and Groups for comprehensive organization and categorization of customer data.

Preferences

The Preferences area stores all customer choices, subscriptions, communication frequencies, engagement channels, and any preference attributes. Designed with built-in rules to honor the right preference, propagate preferences, apply expiration, associate consents, and maintain complete preference history to satisfy compliance audits.

Consents

The Consents area serves as a universal consent repository that stores and manages all customer consents. With limitless granularity, you can attach consents to an individual, device or an application. You can also associate consents to a contact element or a preference communication. Designed with built-in rules to honor the right consent, apply expiration settings, auto-notify when a new consent version becomes available, and maintain complete consent history to satisfy compliance audits.

Base URL

Production:

https://pm.mypreferences.com/Profiles/v2

Sandbox:

https://pmstg.mypreferences.com/Profiles/v2

Language Box

Experience API

The Experience API's, also known as Configuration API's, are a suite of API's purpose-built for retrieving zero-party data configurations to drive highly personalized and relevant customer experiences.

These APIs have built-in localization support and offer specific query parameters to retrieve customized consent, preference, and other zero-party data configurations. This grants you total control over your customers' experiences, covering everything from micro experiences to comprehensive preference centers and everything in between.

These API's are classified as follows:

Both MyPreferences 2.0 customers and MyPreferences 3.0 customers utilizing the Version 2 API's utilize the Preference Configuration APIs. Therefore, MyPreferences 3.0 users who rely on the Version 2 API's should take note of the different routes when working with these API's.

It is important to note that none of the other APIs are relevant or applicable to MyPreferences 3.0 customers.

We highly recommend MyPreferences 3.0 users using the Version 2 API's to switch to Version 4 which offers a central Base URL. To switch to Version 4 API's, simply update the version number from “v2” to “v4” in your Base URL as shown below:

Version 2: https://pm.mypreferences.com/Profiles/v2

Version 4: https://pm.mypreferences.com/Profiles/v4

Update all references that are using the Preference Configuration API as follows:

From: https://pm.mypreferences.com/API/3

To: https://pm.mypreferences.com/Profiles/v4

Profile Configuration

The Profile Configuration API allows you to define all aspects of customer profile configuration including names, contact information, group affiliations, and a wide range of demographic and psychographic details using standard and custom fields.

Additionally, you have the flexibility to create Alternate IDs, such as system and device identifiers, to uniquely identify individuals and devices within your enterprise ecosystem. This API also allows you to create and manage Consents, Tags, Custom Fields, and Groups for comprehensive organization and categorization of customer data.

Preference Configuration

The Preference Configuration API allows you to define and manage all aspects of preference configuration which includes the creation of Programs, Filters, Program Groups, Frequency Options, Preference Attributes, Custom Properties, and Locales.

Preference Configuration APIs

Endpoints

POST
GET
GET
PATCH
POST
GET
PATCH
POST
GET
PATCH
POST
GET
PATCH
POST
PATCH
GET
POST
GET
PATCH
POST
GET
POST
GET
POST
GET
POST
GET
GET
GET
PATCH
PATCH
PATCH
PATCH
POST
GET
GET
PATCH
POST
GET
PATCH
GET
DELETE

Data API

The Data API's facilitate the display and collection of zero-party data for individual profiles across customer touchpoints. When driving customer experiences, they work seamlessly in conjunction with the Experience API to ensure that the relevant elements are accurately displayed on user interfaces, delivering highly personalized customer experiences.

Using the Data API's, you can use any data point on a profile to retrieve the profile. Please note that using contact elements, custom fields, groups, and tags to retrieve a profile may result in multiple matching profiles being returned.

A suite of historical API's are also available as part of this API library. You can retrieve the entire history for any data point associated with a user's profile, including standard fields, contact elements, custom fields, preferences, consents, and more.

Was this section helpful?

What made this section unhelpful for you?

Base URL

Production:

https://pm.mypreferences.com/Profiles/v2

Sandbox:

https://pmstg.mypreferences.com/Profiles/v2

Language Box

Was this section helpful?

What made this section unhelpful for you?

Profile

A Profile represents a unified view of a user across all channels and touchpoints. A user can be a known or an anonymous individual, an application, or an IoT device. The profile record can contain demographic and psychographic information, consents, preferences, group associations, device profile, feedback and any other pieces of zero-party data collected along the customer journey.

Data Organization in MyPreferences

Was this section helpful?

What made this section unhelpful for you?

Add profile

This method allows you to submit a user’s profile, preference, and consent information in a single call to create a unique profile record. The response will include a system generated profileId that can be used to retrieve or edit the profile later.

Header Parameters

Authorizationstring Required

Authorization token

Content-Typestring

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id.A 404 is returned if this value is invalid.

Body Parameters

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdnumber (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

Response

200
Object

Response Attributes

AlternateIdstring
AlternateIdTypestring
ProfileIdinteger (int32)
UpdateStatusstring
SubmittedUtcTimestring
202
Object
Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, the profile is updated. Any subsequent GET operations to retrieve the profile will include a value for the UpdateStatus of either "Complete" or "Pending Update".
400
Object
The request was invalid and cannot be processed. This error may occur as a result of a malformed or syntactically incorrect request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
409
Object
The request could not be completed due to a conflict with the current state of the target resource. In most cases, an instance with the same already exists on the target resource. You must update the request before trying again.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

POST

/{clientId}/Profile

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data '{ "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "SourceId": "sample string 6", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CustomFields": [ { "Name": "sample string 1", "Value": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "Groups": [ { "GroupType": "sample string 1", "IsPrimary": true, "GroupName": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfileTags": [ { "Name": "1" } ], "Addresses": [ { "AddressPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "AddressType": "sample string 1", "IsActive": true, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "SourceId": "sample string 6", "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CassAddress1": "sample string 1", "CassAddress2": "sample string 2", "CassCity": "sample string 3", "CassStateProvince": "sample string 4", "CassPostalCode": "sample string 5", "CassStatus": "sample string 6", "Country": "sample string 7", "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "Address1": "sample string 18", "Address2": "sample string 19", "City": "sample string 20", "StateProvince": "sample string 21", "CountryCode_Numeric": "222", "CountryCode_Alpha2": "US", "CountryCode_Alpha3": "121", "PostalCode": "sample string 22" } ], "Emails": [ { "EmailPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "EmailAddressType": "sample string 1", "EmailAddress": "sample string 2", "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "SourceId": "sample string 6", "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "PhoneNumbers": [ { "PhonePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "PhoneType": "sample string 1", "PhoneNumber": "sample string 2", "PhoneNumberNumeric": 1, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "SourceId": "sample string 6", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsMobile": "false", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfilePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "ProfileId": 1, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "RegistrationConfirmed": true, "CustomerType": "sample string 1", "PreserveConsents": true, "PreservePreferences": true, "CustomerName": { "FirstName": "sample string 1", "MiddleName": "sample string 2", "LastName": "sample string 3", "Prefix": "", "Suffix": "sample string 4" }, "DefaultLocale": "sample string 2", "UpdateStatus": "sample string 3", "ReasonCode": "sample string 4", "AlternateIds": [ { "AlternateIdType": "sample string 1", "AlternateId": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "AlternateIdTypeLink": 1 } ] }'

Response

{
  "AlternateId": "sample string 1",
  "AlternateIdType": "sample string 2",
  "ProfileId": 1,
  "UpdateStatus": "sample string 3",
  "SubmittedUtcTime": "sample string 4"
}
Was this section helpful?

What made this section unhelpful for you?

Update profile

Using this method, you can update a profile directly by utilizing the known profileId without the need to retrieve the profile first. It performs an update operation on all data elements included in the request. Any properties that are not included in your request, but are already present on the profile, will remain unaffected and unchanged.

Header Parameters

Authorizationstring Required

Authorization token

Content-Typestring

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdstring Required

Id of the profile to associate the preferences with.

Body Parameters

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

Response

202
Object
Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, the profile is updated. Any subsequent GET operations to retrieve the profile will include a value for the UpdateStatus of either "Complete" or "Pending Update".
400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found.
409
Object
The request could not be completed due to a conflict with the current state of the target resource. In most cases, an instance with the same already exists on the target resource. You must update the request before trying again.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

POST

/{clientId}/Profile/{profileId}

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/{profileId}' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data '{ "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CustomFields": [ { "Name": "sample string 1", "Value": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "Groups": [ { "GroupType": "sample string 1", "IsPrimary": true, "GroupName": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfileTags": [ { "Name": "1" } ], "Addresses": [ { "AddressPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "AddressType": "sample string 1", "IsActive": true, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CassAddress1": "sample string 1", "CassAddress2": "sample string 2", "CassCity": "sample string 3", "CassStateProvince": "sample string 4", "CassPostalCode": "sample string 5", "CassStatus": "sample string 6", "Country": "sample string 7", "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "Address1": "sample string 18", "Address2": "sample string 19", "City": "sample string 20", "StateProvince": "sample string 21", "CountryCode_Numeric": "222", "CountryCode_Alpha2": "US", "CountryCode_Alpha3": "121", "PostalCode": "sample string 22" } ], "Emails": [ { "EmailPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "EmailAddressType": "sample string 1", "EmailAddress": "sample string 2", "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "PhoneNumbers": [ { "PhonePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "PhoneType": "sample string 1", "PhoneNumber": "sample string 2", "PhoneNumberNumeric": 1, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsMobile": false, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfilePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "ProfileId": 1, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "RegistrationConfirmed": true, "CustomerType": "sample string 1", "PreserveConsents": true, "PreservePreferences": true, "CustomerName": { "FirstName": "sample string 1", "MiddleName": "sample string 2", "LastName": "sample string 3", "Prefix": "", "Suffix": "sample string 4" }, "DefaultLocale": "sample string 2", "UpdateStatus": "sample string 3", "ReasonCode": "sample string 4", "AlternateIds": [ { "AlternateIdType": "sample string 1", "AlternateId": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "AlternateIdTypeLink": 1 } ] }'

Response

Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, the profile is updated. Any subsequent GET operations to retrieve the profile will include a value for the UpdateStatus of either "Complete" or "Pending Update".
Was this section helpful?

What made this section unhelpful for you?

Delete profile

This method allows you to permanently delete a profile and all its associated data. It's important to note that the delete operation is irreversible, so careful consideration is advised before proceeding.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

reasonCodestring

An optional parameter that can be used to store the reason for deletion.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

Id associated with the profile that you want to delete permanently.

Response

204
Object
The request was successfully processed but there is no content to return.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

DELETE

/{clientId}/Profile/{profileId}?reasonCode=

Select
1 2 curl --location --globoff --request DELETE 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/{profileId}' \ --header 'Authorization;' \

Response

The request was successfully processed but there is no content to return.
Was this section helpful?

What made this section unhelpful for you?

Update profile by alternate id

This method is used for inserting and updating a profile using the provided alternate ID and alternateIdType in the request. If the combination of AlternateId and AlternateId Type is found on an existing profile, the profile will be updated with the information provided in the request. In case there is no existing profile with the specified alternateId and alternateIdType, the method will perform an insert operation to create a new profile.

Header Parameters

Authorizationstring Required

Authorization token

Content-Typestring

Query Parameters

alternateIdstring Required

This is the value that uniquely identifies the profile that is being retrieved.

alternateIdTypestring Required

Value that identifies the type of alternate id that is being accessed.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Body Parameters

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

Response

202
Object
Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, the profile is updated. Any subsequent GET operations to retrieve the profile will return with an UpdateStatus of "Complete".
400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found.
409
Object
The request could not be completed due to a conflict with the current state of the target resource. In most cases, an instance with the same already exists on the target resource. You must update the request before trying again.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

POST

/{clientId}/Profile/AlternateId?alternateId=&alternateIdType=

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/AlternateId?alternateId=&alternateIdType=' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data '{ "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CustomFields": [ { "Name": "sample string 1", "Value": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "Groups": [ { "GroupType": "sample string 1", "IsPrimary": true, "GroupName": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfileTags": [ { "Name": "1" } ], "Addresses": [ { "AddressPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "AddressType": "sample string 1", "IsActive": true, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CassAddress1": "sample string 1", "CassAddress2": "sample string 2", "CassCity": "sample string 3", "CassStateProvince": "sample string 4", "CassPostalCode": "sample string 5", "CassStatus": "sample string 6", "Country": "sample string 7", "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "Address1": "sample string 18", "Address2": "sample string 19", "City": "sample string 20", "StateProvince": "sample string 21", "CountryCode_Numeric": "222", "CountryCode_Alpha2": "US", "CountryCode_Alpha3": "121", "PostalCode": "sample string 22" } ], "Emails": [ { "EmailPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "EmailAddressType": "sample string 1", "EmailAddress": "sample string 2", "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "PhoneNumbers": [ { "PhonePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "PhoneType": "sample string 1", "PhoneNumber": "sample string 2", "PhoneNumberNumeric": 1, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsMobile": false, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfilePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "ProfileId": 1, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "RegistrationConfirmed": true, "CustomerType": "sample string 1", "PreserveConsents": true, "PreservePreferences": true, "CustomerName": { "FirstName": "sample string 1", "MiddleName": "sample string 2", "LastName": "sample string 3", "Prefix": "", "Suffix": "sample string 4" }, "DefaultLocale": "sample string 2", "UpdateStatus": "sample string 3", "ReasonCode": "sample string 4", "AlternateIds": [ { "AlternateIdType": "sample string 1", "AlternateId": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "AlternateIdTypeLink": 1 } ] }'

Response

Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, the profile is updated. Any subsequent GET operations to retrieve the profile will return with an UpdateStatus of "Complete".
Was this section helpful?

What made this section unhelpful for you?

Retrieve profile by alternate id

This method will return a single user profile that matches the AlternateId and alternateIdType combination specified in the request.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions. Inactive data elements across all objects are not returned.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Default value
false
matchInactiveboolean

If set to true, returns active and inactive Alternate Ids and Contact Elements. The default setting is false.

Default value
false

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/AlternateId?alternateIdType=&alternateId=&implied=&matchInactive=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/AlternateId?alternateIdType=&alternateId=' \ --header 'Authorization;' \

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Update profile by alternate id (PATCH))

This method allows for partial modifications to be applied to a specific profile using the combination of the alternateId and alternateIdType parameters. The profile will only be updated with the information specified in the path and the values included in the request body.

The HTTP PATCH request method applies partial modifications to a resource. Click here to learn about using PATCH.

The MyPreferences API supports add, replace, remove, and test PATCH operations. The API does not support move and copy PATCH operations.

In the JSON body of your request, send the op, path, and value parameters:

  • op denotes the type of operation to execute such as add, replace, remove, or test.
  • path denotes the path of the target location on the resource to update.
  • value denotes the value to apply.

Note: When removing multiple elements from an array object, send the remove operations in descending order to keep the indices intact.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Body Parameters

Operationsarray

A collection of PATCH operations that you want to perform on the object.

Show child attributes

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

202
Object
Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, a new profile is created. Any subsequent GET operations to retrieve the profile will return with an UpdateStatus of "Complete".
400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

PATCH

/{clientId}/Profile/AlternateId?alternateId=&alternateIdType=

Select
1 2 3 4 5 6 7 8 9 10 11 12 curl --location --globoff --request PATCH 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/AlternateId?alternateId=&alternateIdType=' \ --header 'Authorization;' \ --data '{ "Operations": [ { "value": {}, "path": "sample string 1", "op": "sample string 2", "from": "sample string 3" } ] }'

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Update profile by alternate id (PUT)

By using this method, you can completely replace a profile by matching on the alternateId and alternateIdType parameters. The original information stored in the profile will be overwritten with the data provided in the request.

It's important to note that properties and collections not included in your request will be treated as blank, and will be excluded from the updated profile.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Body Parameters

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
409
Object
The request could not be completed due to a conflict with the current state of the target resource. In most cases, an instance with the same already exists on the target resource. You must update the request before trying again.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

PUT

/{clientId}/Profile/AlternateId?alternateId=&alternateIdType=

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 curl --location --globoff --request PUT 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/AlternateId?alternateId=&alternateIdType=' \ --header 'Authorization;' \ --data '{ "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CustomFields": [ { "Name": "sample string 1", "Value": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "Groups": [ { "GroupType": "sample string 1", "IsPrimary": true, "GroupName": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfileTags": [ { "Name": "1" } ], "Addresses": [ { "AddressPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "AddressType": "sample string 1", "IsActive": true, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CassAddress1": "sample string 1", "CassAddress2": "sample string 2", "CassCity": "sample string 3", "CassStateProvince": "sample string 4", "CassPostalCode": "sample string 5", "CassStatus": "sample string 6", "Country": "sample string 7", "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "Address1": "sample string 18", "Address2": "sample string 19", "City": "sample string 20", "StateProvince": "sample string 21", "CountryCode_Numeric": "222", "CountryCode_Alpha2": "US", "CountryCode_Alpha3": "121", "PostalCode": "sample string 22" } ], "Emails": [ { "EmailPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "EmailAddressType": "sample string 1", "EmailAddress": "sample string 2", "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "PhoneNumbers": [ { "PhonePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "PhoneType": "sample string 1", "PhoneNumber": "sample string 2", "PhoneNumberNumeric": 1, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsMobile": false, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfilePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "ProfileId": 1, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "RegistrationConfirmed": true, "CustomerType": "sample string 1", "PreserveConsents": true, "PreservePreferences": true, "CustomerName": { "FirstName": "sample string 1", "MiddleName": "sample string 2", "LastName": "sample string 3", "Prefix": "", "Suffix": "sample string 4" }, "DefaultLocale": "sample string 2", "UpdateStatus": "sample string 3", "ReasonCode": "sample string 4", "AlternateIds": [ { "AlternateIdType": "sample string 1", "AlternateId": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "AlternateIdTypeLink": 1 } ] }'

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve profile by profile id

This method will return a single user profile that matches the profileId specified in the request.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions. Inactive data elements across all objects are not returned.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

This is the value that uniquely identifies the profile that is being retrieved.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/{profileId}?implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/{profileId}' \ --header 'Authorization;' \

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Update profile (PUT)

This method allows you to overwrite a profile by specifying the corresponding profileId.

The original information contained in the profile will be overwritten by the information contained in the request. Properties and collections that are not included in the PUT request will be considered blank, and will no longer be included in the profile.

Header Parameters

Authorizationstring Required

Authorization token

Content-Typestring

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

Id of the Profile to update.

Body Parameters

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

202
Object
Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, a new profile is created. Any subsequent GET operations to retrieve the profile will return with an UpdateStatus of "Complete".
400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
409
Object
The request could not be completed due to a conflict with the current state of the target resource. In most cases, an instance with the same already exists on the target resource. You must update the request before trying again.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

PUT

/{clientId}/Profile/{profileId}

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 curl --location --globoff --request PUT 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/{profileId}' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data '{ "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CustomFields": [ { "Name": "sample string 1", "Value": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "Groups": [ { "GroupType": "sample string 1", "IsPrimary": true, "GroupName": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfileTags": [ { "Name": "1" } ], "Addresses": [ { "AddressPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "AddressType": "sample string 1", "IsActive": true, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "CassAddress1": "sample string 1", "CassAddress2": "sample string 2", "CassCity": "sample string 3", "CassStateProvince": "sample string 4", "CassPostalCode": "sample string 5", "CassStatus": "sample string 6", "Country": "sample string 7", "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "Address1": "sample string 18", "Address2": "sample string 19", "City": "sample string 20", "StateProvince": "sample string 21", "CountryCode_Numeric": "222", "CountryCode_Alpha2": "US", "CountryCode_Alpha3": "121", "PostalCode": "sample string 22" } ], "Emails": [ { "EmailPreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "EmailAddressType": "sample string 1", "EmailAddress": "sample string 2", "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "PhoneNumbers": [ { "PhonePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "PhoneType": "sample string 1", "PhoneNumber": "sample string 2", "PhoneNumberNumeric": 1, "IsDefault": true, "Consents": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "Locale": "en_US", "ConsentStatus": 2, "ReasonCode": "sample string 3", "ConsentDate": "sample string 4", "ExpirationDate": "sample string 5", "Expired": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "UpdatedVersionPending": true, "IsActive": true } ], "IsMobile": false, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" } } ], "ProfilePreferences": [ { "ProgramId": "sample string 1", "ChannelId": "sample string 2", "ConsentAssociations": [ { "ConsentType": "sample string 1", "ConsentVersion": "sample string 2", "IsActive": true, "Locale": "en_US", "ReasonCode": "sample string 3" } ], "MatchType": "sample string 3", "ReasonCode": "sample string 4", "ExpirationDate": "sample string 5", "PreferenceStatus": "sample string 6", "LastModifiedDate": "sample string 7", "UserId": "sample string 8", "SourceId": "sample string 9", "FilterId": "sample string 10", "PreferenceType": 2, "FrequencyId": "sample string 11", "PreferenceAttributes": [ { "Key": "sample string 1", "Value": "sample string 2" } ], "CustomerDate": "sample string 12" } ], "ProfileId": 1, "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "RegistrationConfirmed": true, "CustomerType": "sample string 1", "PreserveConsents": true, "PreservePreferences": true, "CustomerName": { "FirstName": "sample string 1", "MiddleName": "sample string 2", "LastName": "sample string 3", "Prefix": "", "Suffix": "sample string 4" }, "DefaultLocale": "sample string 2", "UpdateStatus": "sample string 3", "ReasonCode": "sample string 4", "AlternateIds": [ { "AlternateIdType": "sample string 1", "AlternateId": "sample string 2", "IsActive": true, "Edited": { "CreateDate": "sample string 1", "CreatedBy": "sample string 2", "ModifiedDate": "sample string 3", "ModifiedBy": "sample string 4" }, "AlternateIdTypeLink": 1 } ] }'

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Update profile (PATCH)

The PATCH method applies partial modifications to a single profile specified by the profileId parameter. The profile will only be updated with the information specified in the path and the values included in the request body.

The HTTP PATCH request method applies partial modifications to a resource. Click here to learn about using PATCH.

The MyPreferences API supports add, replace, remove, and test PATCH operations. The API does not support move and copy PATCH operations.

In the JSON body of your request, send the op, path, and value parameters:

  • op denotes the type of operation to execute such as add, replace, remove, or test.

  • path denotes the path of the target location on the resource to update.

  • value denotes the value to apply.

Note: When removing multiple elements from an array object, send the remove operations in descending order to keep the indices intact.

Header Parameters

Authorizationstring Required

Authorization token

Content-Typestring

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

Id associated with the profile.

Body Parameters

opstring

Operation to be performed on the target object. Valid values are: add/remove/replace/test.

pathstring

JSON pointer that references a location within the target document where the operation is performed.

fromstring

JSON pointer to the location to copy or move.

valueobject

Value to be added or replaced.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

202
Object
Once the request is received, it is queued for processing and a 202 response is returned with the UpdateStatus of "Pending Update". When processing is completed, a new profile is created. Any subsequent GET operations to retrieve the profile will return with an UpdateStatus of "Complete".
400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

PATCH

/{clientId}/Profile/{profileId}

Select
1 2 3 4 5 6 7 8 9 10 11 curl --location --globoff --request PATCH 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/{profileId}' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data '[ { "op": "string", "path": "string", "from": "string", "value": {} } ]'

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical consents by profile id

This method will return complete consent history for a single profile using the profileId parameter.

Only the basic profile information and consent history will be returned. Elements like custom fields, groups, tags, and preferences will not be included in the response. Consent history will be returned in ascending order by Consent Type, Version, and Modified date.

Header Parameters

Authorizationstring Required

Authorization token

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

This is the value that uniquely identifies the profile that is being retrieved.

Response

200
Object

Response Attributes

Consentsarray

A collection of Custom Fields associated with the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/Consents/{profileId}

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/Consents/{profileId}' \ --header 'Authorization;' \

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": false,
  "CustomerType": "sample string 2",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 3",
  "UpdateStatus": "sample string 4",
  "ReasonCode": "sample string 5",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical consents by alternate id

This method will return complete consent history associated with a specific profile using the combination of the alternateId and alternateIdType parameters.

Only the basic profile information and consent history will be returned. Custom fields, groups, tags, and preferences will not be included in the response. Consent history will be returned in ascending order by Consent Type, Version, and Modified date.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of Custom Fields associated with the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/Consents/AlternateId?alternateIdType=&alternateId=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/Consents/AlternateId?alternateIdType=&alternateId=' \ --header 'Authorization;' \

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": false,
  "CustomerType": "sample string 2",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 3",
  "UpdateStatus": "sample string 4",
  "ReasonCode": "sample string 5",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical contact elements by profile id

This method retrieves the complete history of contact elements for a single profile, including any attached consent associations. Profile-only consents, custom fields, groups, tags, and preferences will not be returned.

Header Parameters

Authorizationstring Required

Authorization token

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

This is the value that uniquely identifies the profile that is being retrieved.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server is unable to handle your request due to a temporary condition. You must delay your request for some time before trying again. Notify PossibleNOW Support if it’s a continuous occurrence
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/ContactElements/{profileId}

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/ContactElements/{profileId}' \ --header 'Authorization;' \

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical contact elements by alternate id

Using the combination of the alternateId and alternateIdType parameters, this method retrieves complete history of contact elements for a single profile, including any attached consent associations.

Profile-only consents, custom fields, groups, tags, and preferences will not be returned.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server is unable to handle your request due to a temporary condition. You must delay your request for some time before trying again. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/ContactElements/AlternateId?alternateIdType=&alternateId=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/ContactElements/AlternateId?alternateIdType=&alternateId=' \ --header 'Authorization;' \

Response

{
  "Consents": [
    {
      "ConsentType": "sample string 1",
      "ConsentVersion": "sample string 2",
      "Locale": "en_US",
      "ConsentStatus": 2,
      "ReasonCode": "sample string 3",
      "ConsentDate": "sample string 4",
      "ExpirationDate": "sample string 5",
      "Expired": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "UpdatedVersionPending": true,
      "IsActive": true
    }
  ],
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "Groups": [
    {
      "GroupType": "sample string 1",
      "IsPrimary": true,
      "GroupName": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileTags": [
    {
      "Name": "1"
    }
  ],
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical custom fields by profile id

This method will return complete custom field history for a single profile using the profileId parameter.

Only the basic profile information and custom field history will be returned. Elements like consents, groups, tags, and preferences will not be included in the response. Custom field history will be returned in ascending order by Modified date.

Header Parameters

Authorizationstring Required

Authorization token

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

This is the value that uniquely identifies the profile that is being retrieved.

Response

200
Object

Response Attributes

CustomFieldsarray

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/CustomFields/{profileId}

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/CustomFields/{profileId}' \ --header 'Authorization;' \

Response

{
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": false,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical custom fields by alternate id

Using the combination of the alternateId and alternateIdType parameters, this method retrieves complete history of custom fields for a single profile.

Consents, custom fields, groups, tags, and preferences will not be returned. Custom field history will be returned in ascending order by Modified date.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

CustomFieldsarray

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/CustomFields/AlternateId?alternateIdType=&alternateId=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/CustomFields/AlternateId?alternateIdType=&alternateId=' \ --header 'Authorization;' \

Response

{
  "CustomFields": [
    {
      "Name": "sample string 1",
      "Value": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": false,
  "PreservePreferences": true,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical preferences by profile id

This method will return current and historical preferences for a single profile using the profileId parameter.

Only the basic profile information, contacts, and preference history will be returned. Custom fields, groups, tags, and consents will not be included in the response.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

filterIdstring

To limit the results to preferences assocated with the filter.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

This is the value that uniquely identifies the profile that is being retrieved.

Response

200
Object

Response Attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/Preferences/{profileId}?filterId=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/Preferences/{profileId}' \ --header 'Authorization;' \

Response

{
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": false,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical preferences by alternate id

Using the combination of the alternateId and alternateIdType parameters, this method retrieves complete history of preferences for a single profile. Use the optional query parameter filterId to only retrieve the history for a specific Filter.

Consents, custom fields, groups, and tags will not be returned.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

filterIdstring

To limit the results to preferences assocated with the filter.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
500
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/Preferences/AlternateId?alternateIdType=&alternateId=&filterId=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/Preferences/AlternateId?alternateIdType=&alternateId=' \ --header 'Authorization;' \

Response

{
  "Addresses": [
    {
      "AddressPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "AddressType": "sample string 1",
      "IsActive": true,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CassAddress1": "sample string 1",
      "CassAddress2": "sample string 2",
      "CassCity": "sample string 3",
      "CassStateProvince": "sample string 4",
      "CassPostalCode": "sample string 5",
      "CassStatus": "sample string 6",
      "Country": "sample string 7",
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "Address1": "sample string 18",
      "Address2": "sample string 19",
      "City": "sample string 20",
      "StateProvince": "sample string 21",
      "CountryCode_Numeric": "222",
      "CountryCode_Alpha2": "US",
      "CountryCode_Alpha3": "121",
      "PostalCode": "sample string 22"
    }
  ],
  "Emails": [
    {
      "EmailPreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "EmailAddressType": "sample string 1",
      "EmailAddress": "sample string 2",
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "PhoneNumbers": [
    {
      "PhonePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "PhoneType": "sample string 1",
      "PhoneNumber": "sample string 2",
      "PhoneNumberNumeric": 1,
      "IsDefault": true,
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "IsMobile": false,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      }
    }
  ],
  "ProfilePreferences": [
    {
      "ProgramId": "sample string 1",
      "ChannelId": "sample string 2",
      "ConsentAssociations": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "IsActive": true,
          "Locale": "en_US",
          "ReasonCode": "sample string 3"
        }
      ],
      "MatchType": "sample string 3",
      "ReasonCode": "sample string 4",
      "ExpirationDate": "sample string 5",
      "PreferenceStatus": "sample string 6",
      "LastModifiedDate": "sample string 7",
      "UserId": "sample string 8",
      "SourceId": "sample string 9",
      "FilterId": "sample string 10",
      "PreferenceType": 2,
      "FrequencyId": "sample string 11",
      "PreferenceAttributes": [
        {
          "Key": "sample string 1",
          "Value": "sample string 2"
        }
      ],
      "CustomerDate": "sample string 12"
    }
  ],
  "ProfileId": 1,
  "IsActive": true,
  "Edited": {
    "CreateDate": "sample string 1",
    "CreatedBy": "sample string 2",
    "ModifiedDate": "sample string 3",
    "ModifiedBy": "sample string 4"
  },
  "RegistrationConfirmed": true,
  "CustomerType": "sample string 1",
  "PreserveConsents": true,
  "PreservePreferences": false,
  "CustomerName": {
    "FirstName": "sample string 1",
    "MiddleName": "sample string 2",
    "LastName": "sample string 3",
    "Prefix": "",
    "Suffix": "sample string 4"
  },
  "DefaultLocale": "sample string 2",
  "UpdateStatus": "sample string 3",
  "ReasonCode": "sample string 4",
  "AlternateIds": [
    {
      "AlternateIdType": "sample string 1",
      "AlternateId": "sample string 2",
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "AlternateIdTypeLink": 1
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical standard fields by profile id

This method will return complete history of standard fields for a specific profile using the profileId parameter.

Only the basic profile information and standard field history will be returned. Elements like consents, custom fields, groups, tags, and preferences will not be included in the response. Standard field history will be returned in ascending order by Modified date.

Along with the ProfileId, a collection of current AlternateIds is also included with each historical entry.

Header Parameters

Authorizationstring Required

Authorization token

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

This is the value that uniquely identifies the profile that is being retrieved.

Response

200
Object

Response Attributes

UserProfilePreferencesarray

Collection of UserProfilePreferences

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server is unable to handle your request due to a temporary condition. You must delay your request for some time before trying again. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/StandardFields/{profileId}

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/StandardFields/{profileId}' \ --header 'Authorization;' \

Response

{
  "UserProfilePreferences": [
    {
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CustomFields": [
        {
          "Name": "sample string 1",
          "Value": "sample string 2",
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "Groups": [
        {
          "GroupType": "sample string 1",
          "IsPrimary": true,
          "GroupName": "sample string 2",
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "ProfileTags": [
        {
          "Name": "1"
        }
      ],
      "Addresses": [
        {
          "AddressPreferences": [
            {
              "ProgramId": "sample string 1",
              "ChannelId": "sample string 2",
              "ConsentAssociations": [
                {
                  "ConsentType": "sample string 1",
                  "ConsentVersion": "sample string 2",
                  "IsActive": true,
                  "Locale": "en_US",
                  "ReasonCode": "sample string 3"
                }
              ],
              "MatchType": "sample string 3",
              "ReasonCode": "sample string 4",
              "ExpirationDate": "sample string 5",
              "PreferenceStatus": "sample string 6",
              "LastModifiedDate": "sample string 7",
              "UserId": "sample string 8",
              "SourceId": "sample string 9",
              "FilterId": "sample string 10",
              "PreferenceType": 2,
              "FrequencyId": "sample string 11",
              "PreferenceAttributes": [
                {
                  "Key": "sample string 1",
                  "Value": "sample string 2"
                }
              ],
              "CustomerDate": "sample string 12"
            }
          ],
          "AddressType": "sample string 1",
          "IsActive": true,
          "IsDefault": true,
          "Consents": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "Locale": "en_US",
              "ConsentStatus": 2,
              "ReasonCode": "sample string 3",
              "ConsentDate": "sample string 4",
              "ExpirationDate": "sample string 5",
              "Expired": true,
              "Edited": {
                "CreateDate": "sample string 1",
                "CreatedBy": "sample string 2",
                "ModifiedDate": "sample string 3",
                "ModifiedBy": "sample string 4"
              },
              "UpdatedVersionPending": true,
              "IsActive": true
            }
          ],
          "CassAddress1": "sample string 1",
          "CassAddress2": "sample string 2",
          "CassCity": "sample string 3",
          "CassStateProvince": "sample string 4",
          "CassPostalCode": "sample string 5",
          "CassStatus": "sample string 6",
          "Country": "sample string 7",
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "Address1": "sample string 18",
          "Address2": "sample string 19",
          "City": "sample string 20",
          "StateProvince": "sample string 21",
          "CountryCode_Numeric": "222",
          "CountryCode_Alpha2": "US",
          "CountryCode_Alpha3": "121",
          "PostalCode": "sample string 22"
        }
      ],
      "Emails": [
        {
          "EmailPreferences": [
            {
              "ProgramId": "sample string 1",
              "ChannelId": "sample string 2",
              "ConsentAssociations": [
                {
                  "ConsentType": "sample string 1",
                  "ConsentVersion": "sample string 2",
                  "IsActive": true,
                  "Locale": "en_US",
                  "ReasonCode": "sample string 3"
                }
              ],
              "MatchType": "sample string 3",
              "ReasonCode": "sample string 4",
              "ExpirationDate": "sample string 5",
              "PreferenceStatus": "sample string 6",
              "LastModifiedDate": "sample string 7",
              "UserId": "sample string 8",
              "SourceId": "sample string 9",
              "FilterId": "sample string 10",
              "PreferenceType": 2,
              "FrequencyId": "sample string 11",
              "PreferenceAttributes": [
                {
                  "Key": "sample string 1",
                  "Value": "sample string 2"
                }
              ],
              "CustomerDate": "sample string 12"
            }
          ],
          "EmailAddressType": "sample string 1",
          "EmailAddress": "sample string 2",
          "IsDefault": true,
          "Consents": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "Locale": "en_US",
              "ConsentStatus": 2,
              "ReasonCode": "sample string 3",
              "ConsentDate": "sample string 4",
              "ExpirationDate": "sample string 5",
              "Expired": true,
              "Edited": {
                "CreateDate": "sample string 1",
                "CreatedBy": "sample string 2",
                "ModifiedDate": "sample string 3",
                "ModifiedBy": "sample string 4"
              },
              "UpdatedVersionPending": true,
              "IsActive": true
            }
          ],
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "PhoneNumbers": [
        {
          "PhonePreferences": [
            {
              "ProgramId": "sample string 1",
              "ChannelId": "sample string 2",
              "ConsentAssociations": [
                {
                  "ConsentType": "sample string 1",
                  "ConsentVersion": "sample string 2",
                  "IsActive": true,
                  "Locale": "en_US",
                  "ReasonCode": "sample string 3"
                }
              ],
              "MatchType": "sample string 3",
              "ReasonCode": "sample string 4",
              "ExpirationDate": "sample string 5",
              "PreferenceStatus": "sample string 6",
              "LastModifiedDate": "sample string 7",
              "UserId": "sample string 8",
              "SourceId": "sample string 9",
              "FilterId": "sample string 10",
              "PreferenceType": 2,
              "FrequencyId": "sample string 11",
              "PreferenceAttributes": [
                {
                  "Key": "sample string 1",
                  "Value": "sample string 2"
                }
              ],
              "CustomerDate": "sample string 12"
            }
          ],
          "PhoneType": "sample string 1",
          "PhoneNumber": "sample string 2",
          "PhoneNumberNumeric": 1,
          "IsDefault": true,
          "Consents": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "Locale": "en_US",
              "ConsentStatus": 2,
              "ReasonCode": "sample string 3",
              "ConsentDate": "sample string 4",
              "ExpirationDate": "sample string 5",
              "Expired": true,
              "Edited": {
                "CreateDate": "sample string 1",
                "CreatedBy": "sample string 2",
                "ModifiedDate": "sample string 3",
                "ModifiedBy": "sample string 4"
              },
              "UpdatedVersionPending": true,
              "IsActive": true
            }
          ],
          "IsMobile": false,
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "ProfilePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "ProfileId": 1,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "RegistrationConfirmed": true,
      "CustomerType": "sample string 1",
      "PreserveConsents": true,
      "PreservePreferences": true,
      "CustomerName": {
        "FirstName": "sample string 1",
        "MiddleName": "sample string 2",
        "LastName": "sample string 3",
        "Prefix": "",
        "Suffix": "sample string 4"
      },
      "DefaultLocale": "sample string 2",
      "UpdateStatus": "sample string 3",
      "ReasonCode": "sample string 4",
      "AlternateIds": [
        {
          "AlternateIdType": "sample string 1",
          "AlternateId": "sample string 2",
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "AlternateIdTypeLink": 1
        }
      ]
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve historical standard fields by alternate id

Using the combination of the alternateId and alternateIdType parameters, this method retrieves complete history of standard fields for a single profile.

Consents, preferences, custom fields, groups, and tags will not be returned.

Along with the profileId, a collection of current alternateIds is also included with each historical entry.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

alternateIdstring Required

Alternate Id value that uniquely identifies the profile that is being retrieved.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

UserProfilePreferencesarray

Collection of UserProfilePreferences

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server is unable to handle your request due to a temporary condition. You must delay your request for some time before trying again. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/History/StandardFields/AlternateId?alternateIdType=&alternateId=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/History/StandardFields/AlternateId?alternateIdType=&alternateId=' \ --header 'Authorization;' \

Response

{
  "UserProfilePreferences": [
    {
      "Consents": [
        {
          "ConsentType": "sample string 1",
          "ConsentVersion": "sample string 2",
          "Locale": "en_US",
          "ConsentStatus": 2,
          "ReasonCode": "sample string 3",
          "ConsentDate": "sample string 4",
          "ExpirationDate": "sample string 5",
          "Expired": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "UpdatedVersionPending": true,
          "IsActive": true
        }
      ],
      "CustomFields": [
        {
          "Name": "sample string 1",
          "Value": "sample string 2",
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "Groups": [
        {
          "GroupType": "sample string 1",
          "IsPrimary": true,
          "GroupName": "sample string 2",
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "ProfileTags": [
        {
          "Name": "1"
        }
      ],
      "Addresses": [
        {
          "AddressPreferences": [
            {
              "ProgramId": "sample string 1",
              "ChannelId": "sample string 2",
              "ConsentAssociations": [
                {
                  "ConsentType": "sample string 1",
                  "ConsentVersion": "sample string 2",
                  "IsActive": true,
                  "Locale": "en_US",
                  "ReasonCode": "sample string 3"
                }
              ],
              "MatchType": "sample string 3",
              "ReasonCode": "sample string 4",
              "ExpirationDate": "sample string 5",
              "PreferenceStatus": "sample string 6",
              "LastModifiedDate": "sample string 7",
              "UserId": "sample string 8",
              "SourceId": "sample string 9",
              "FilterId": "sample string 10",
              "PreferenceType": 2,
              "FrequencyId": "sample string 11",
              "PreferenceAttributes": [
                {
                  "Key": "sample string 1",
                  "Value": "sample string 2"
                }
              ],
              "CustomerDate": "sample string 12"
            }
          ],
          "AddressType": "sample string 1",
          "IsActive": true,
          "IsDefault": true,
          "Consents": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "Locale": "en_US",
              "ConsentStatus": 2,
              "ReasonCode": "sample string 3",
              "ConsentDate": "sample string 4",
              "ExpirationDate": "sample string 5",
              "Expired": true,
              "Edited": {
                "CreateDate": "sample string 1",
                "CreatedBy": "sample string 2",
                "ModifiedDate": "sample string 3",
                "ModifiedBy": "sample string 4"
              },
              "UpdatedVersionPending": true,
              "IsActive": true
            }
          ],
          "CassAddress1": "sample string 1",
          "CassAddress2": "sample string 2",
          "CassCity": "sample string 3",
          "CassStateProvince": "sample string 4",
          "CassPostalCode": "sample string 5",
          "CassStatus": "sample string 6",
          "Country": "sample string 7",
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "Address1": "sample string 18",
          "Address2": "sample string 19",
          "City": "sample string 20",
          "StateProvince": "sample string 21",
          "CountryCode_Numeric": "222",
          "CountryCode_Alpha2": "US",
          "CountryCode_Alpha3": "121",
          "PostalCode": "sample string 22"
        }
      ],
      "Emails": [
        {
          "EmailPreferences": [
            {
              "ProgramId": "sample string 1",
              "ChannelId": "sample string 2",
              "ConsentAssociations": [
                {
                  "ConsentType": "sample string 1",
                  "ConsentVersion": "sample string 2",
                  "IsActive": true,
                  "Locale": "en_US",
                  "ReasonCode": "sample string 3"
                }
              ],
              "MatchType": "sample string 3",
              "ReasonCode": "sample string 4",
              "ExpirationDate": "sample string 5",
              "PreferenceStatus": "sample string 6",
              "LastModifiedDate": "sample string 7",
              "UserId": "sample string 8",
              "SourceId": "sample string 9",
              "FilterId": "sample string 10",
              "PreferenceType": 2,
              "FrequencyId": "sample string 11",
              "PreferenceAttributes": [
                {
                  "Key": "sample string 1",
                  "Value": "sample string 2"
                }
              ],
              "CustomerDate": "sample string 12"
            }
          ],
          "EmailAddressType": "sample string 1",
          "EmailAddress": "sample string 2",
          "IsDefault": true,
          "Consents": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "Locale": "en_US",
              "ConsentStatus": 2,
              "ReasonCode": "sample string 3",
              "ConsentDate": "sample string 4",
              "ExpirationDate": "sample string 5",
              "Expired": true,
              "Edited": {
                "CreateDate": "sample string 1",
                "CreatedBy": "sample string 2",
                "ModifiedDate": "sample string 3",
                "ModifiedBy": "sample string 4"
              },
              "UpdatedVersionPending": true,
              "IsActive": true
            }
          ],
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "PhoneNumbers": [
        {
          "PhonePreferences": [
            {
              "ProgramId": "sample string 1",
              "ChannelId": "sample string 2",
              "ConsentAssociations": [
                {
                  "ConsentType": "sample string 1",
                  "ConsentVersion": "sample string 2",
                  "IsActive": true,
                  "Locale": "en_US",
                  "ReasonCode": "sample string 3"
                }
              ],
              "MatchType": "sample string 3",
              "ReasonCode": "sample string 4",
              "ExpirationDate": "sample string 5",
              "PreferenceStatus": "sample string 6",
              "LastModifiedDate": "sample string 7",
              "UserId": "sample string 8",
              "SourceId": "sample string 9",
              "FilterId": "sample string 10",
              "PreferenceType": 2,
              "FrequencyId": "sample string 11",
              "PreferenceAttributes": [
                {
                  "Key": "sample string 1",
                  "Value": "sample string 2"
                }
              ],
              "CustomerDate": "sample string 12"
            }
          ],
          "PhoneType": "sample string 1",
          "PhoneNumber": "sample string 2",
          "PhoneNumberNumeric": 1,
          "IsDefault": true,
          "Consents": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "Locale": "en_US",
              "ConsentStatus": 2,
              "ReasonCode": "sample string 3",
              "ConsentDate": "sample string 4",
              "ExpirationDate": "sample string 5",
              "Expired": true,
              "Edited": {
                "CreateDate": "sample string 1",
                "CreatedBy": "sample string 2",
                "ModifiedDate": "sample string 3",
                "ModifiedBy": "sample string 4"
              },
              "UpdatedVersionPending": true,
              "IsActive": true
            }
          ],
          "IsMobile": false,
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          }
        }
      ],
      "ProfilePreferences": [
        {
          "ProgramId": "sample string 1",
          "ChannelId": "sample string 2",
          "ConsentAssociations": [
            {
              "ConsentType": "sample string 1",
              "ConsentVersion": "sample string 2",
              "IsActive": true,
              "Locale": "en_US",
              "ReasonCode": "sample string 3"
            }
          ],
          "MatchType": "sample string 3",
          "ReasonCode": "sample string 4",
          "ExpirationDate": "sample string 5",
          "PreferenceStatus": "sample string 6",
          "LastModifiedDate": "sample string 7",
          "UserId": "sample string 8",
          "SourceId": "sample string 9",
          "FilterId": "sample string 10",
          "PreferenceType": 2,
          "FrequencyId": "sample string 11",
          "PreferenceAttributes": [
            {
              "Key": "sample string 1",
              "Value": "sample string 2"
            }
          ],
          "CustomerDate": "sample string 12"
        }
      ],
      "ProfileId": 1,
      "IsActive": true,
      "Edited": {
        "CreateDate": "sample string 1",
        "CreatedBy": "sample string 2",
        "ModifiedDate": "sample string 3",
        "ModifiedBy": "sample string 4"
      },
      "RegistrationConfirmed": true,
      "CustomerType": "sample string 1",
      "PreserveConsents": true,
      "PreservePreferences": true,
      "CustomerName": {
        "FirstName": "sample string 1",
        "MiddleName": "sample string 2",
        "LastName": "sample string 3",
        "Prefix": "",
        "Suffix": "sample string 4"
      },
      "DefaultLocale": "sample string 2",
      "UpdateStatus": "sample string 3",
      "ReasonCode": "sample string 4",
      "AlternateIds": [
        {
          "AlternateIdType": "sample string 1",
          "AlternateId": "sample string 2",
          "IsActive": true,
          "Edited": {
            "CreateDate": "sample string 1",
            "CreatedBy": "sample string 2",
            "ModifiedDate": "sample string 3",
            "ModifiedBy": "sample string 4"
          },
          "AlternateIdTypeLink": 1
        }
      ]
    }
  ]
}
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by address

This method returns one or more profiles that have an exact match on the mailing address field values specified in the request. Passing minimal data in the parameters may result in multiple profiles being returned.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

To increase the likelihood of finding the desired profile, it is recommended to include all available address fields as query parameters. All fields passed in the request must match the corresponding values in the profile for the record to be returned.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Plain Text

Select...
GET {clientId}/Profile/Address?address1=Jefferson Drive&city=Roswell&stateProvince=GA&addressType=Home&firstName=Audrey&middleName=Julia&lastName=Michaels&partialAddress1Match=true&partialNameMatch=true

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

address1string

First line of the mailing address in the profile being searched on.

address2string

Second line of the mailing address in the profile being searched on.

citystring Required

City, Town, or Village of the mailing address in the profile being searched on.

stateProvincestring Required

Province state or district identified in the profile being searched on.

postalCodestring

The postal or zip code identified in the address in the profile being searched on.

addressTypestring

This is to filter the results on a specific 'Address type' as defined under 'Contact Types' in MyPreferences. As an example this may include home, business, store, or PO Box addresses.

firstNamestring

First name of the person whose profile is being searched on.

middleNamestring

Middle name of the person whose profile is being searched on.

lastNamestring

Last name of the person whose profile is being searched on.

partialAddress1Matchboolean

A boolean property when set to true will match on partial address1 field values (Not address 2) For example: When this property is set to true and the user passes in 'Camden', the results will match on '12 Camden Lane' or '134 Camdenisk Way', but not 'Cameron' or '1453 Camdin Rd'. Defaults to false.

partialNameMatchboolean

A boolean property when set to true will match on partial name fields (firstName, MiddleName, lastName). For example: When this property is set to true and the user passes in a first name of 'Bill' and last name of 'Day', the results will match 'Bill Dayton' or 'Billy Day', but not 'Will Day' or 'Bill David'. Defaults to false.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Address?address1=&address2=&city=&stateProvince=&postalCode=&addressType=&firstName=&middleName=&lastName=&partialAddress1Match=&partialNameMatch=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Address?city=&stateProvince=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by custom fields

This method returns one or more profiles that meet the custom field criteria specified in the query string. It supports filtering on multiple custom fields, and the parameters are passed as an array. The first field and value combination start with index 0.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

All active consents, custom fields, groups, tags, and preferences for which you have permissions will be returned in the response.

Plain Text

Select...
GET {clientId}/Profile/CustomFields?customFields[0].Name=alpha&customFields[0].Value=couch&customFields[1].Name=beta&customFields[1].Value=book

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

customFieldsstring Required

An array of custom field search criteria which is organized by the SearchCustomFieldValue collection. This will be arranged by Name and Value pairs that will represent the customer fields to search on. The parameters are read in as an array with the first field and value combination starting with 0.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/CustomFields?customFields=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/CustomFields?customFields=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by SelectList custom fields

This method enhances the capability to search for profiles based on custom fields by incorporating operators for each custom field. These operators, which includes, Equals, All of, or Any of, allow for greater flexibility in filtering the customFields.Value parameter and evaluating its values.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Plain Text

Select...
GET {clientId}/Profile/CustomFields/SelectList? customFields[0].OperatorId=3&customFields[0].Name=alpha&customFields[0].Value=couch:chair:table

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

customFieldsstring Required

An array of custom field search criteria which is organized by the SearchCustomFieldSelectListValue collection. The custom fields for searching must be organized based on the Operator, Name, and Value properties. The parameters must be provided as an array, with the first field and value combination starting at index 0.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/CustomFields/SelectList?customFields=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/CustomFields/SelectList?customFields=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by email

This method will retrieve one or more profiles that match the email address specified in the request. Use the optional query parameter emailType to limit the returned results to a specific email type.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

emailAddressstring Required

Email address that will be used to retrieve the profile.

emailTypestring

This is to filter the results on a specific email address type as defined under "Contact Types" in MyPreferences. As examples this may include personal, employee, or shared.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Email?emailAddress=&emailType=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Email?emailAddress=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by name

This method will retrieve one or more profiles that have an exact match on the firstName, middleName and lastName values specified in the request.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

lastNamestring Required

Last name used to retrieve the matching profile(s).

firstNamestring

First name used to retrieve the matching profile(s).

middleNamestring

Middle name used to retrieve the matching profile(s).

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Name?lastName=&firstName=&middleName=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Name?lastName=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by partial name

This method will retrieve one or more profiles that have a partial match on the firstName, middleName, and lastName values specified in the request.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

For example, suppose we specify the lastName parameter as 'Smi'. In this case, the matching process will look for last names that contain the substring 'Smi'. As a result, last names like 'Smith' or 'Smilla' would be considered as matches because they contain the substring 'Smi'. However, last names such as 'Small' or 'Sampson' would not be considered as matches because they do not contain the exact substring 'Smi'.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

lastNamestring Required

Last name used to retrieve the matching profile(s).

firstNamestring

First name used to retrieve the matching profile(s).

middleNamestring

Middle name used to retrieve the matching profile(s).

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Name/Partial?lastName=&firstName=&middleName=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Name/Partial?lastName=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by phone

This method will retrieve one or more profiles that match the phone number specified in the request. Use the optional query parameter phoneType to limit the returned results to a specific phone type.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

phoneNumberstring Required

The phone number digits that will be used to retrieve the profile.

phoneTypestring

This is to filter the results on a specific phone number type as defined under 'Contact Types' in MyPreferences. As examples this may include home, mobile, business, or public.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Phone?phoneNumber=&phoneType=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Phone?phoneNumber=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by preference attributes

This method returns one or more profiles that meet the preference attribute criteria specified in the query string. It supports filtering on multiple preference attributes, and the parameters are passed as an array. The first key and value combination start with index 0.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

All active consents, custom fields, groups, tags, and preferences for which you have permissions will be returned in the response.

Plain Text

Select...
GET {clientId}/Profiles/Attributes?attributes[0].Key=alpha&attributes[0].Value=phone&attributes[1].Key=beta&attributes[1].Value=account

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

attributesstring Required

An array of attributes search criteria which is organized by the SearchPreferenceAttribute collection. This will be arranged by Key and Value pairs that will represent the customer fields to search on. The parameters are read in as an array with the first field and value combination starting with 0.

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Attributes?attributes=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Attributes?attributes=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve profiles by tags

This method will retrieve one or more profiles that match the tag values specified in the request. Tag parameters are read as an array where the first tag value begins with index 0, followed by subsequent values.

This method can only return up to 50 profiles. If more than 50 matching profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Plain Text

Select...
GET {clientId}/Profiles/Tags?tag[0]=tester&tag[1]=preferred&exactMatch=false&implied=true

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

tagstring Required

List of tags used to retrieve the data. Tags are read in as an array with the first tag value starting with 0. All tag values that are identified in the parameters need to match a profile for it to be returned in the response.

exactMatchboolean

Boolean flag that when set to false, returns profile(s) that match on any of the tags in tagList. When this value is set to true, all of the tags that are in the tagList must match for the profile to be returned. Defaults to true.

multipleProfilesboolean

Boolean flag that when set to true, returns all profile(s) that match on any of the tags in tagList. Defaults to false.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Tags?tag=&exactMatch=&multipleProfiles=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Tags?tag=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve group profiles by alternate id

This method will retrieve one or more profiles that are part of a group by using the alternateId and alternateIdType combination of the group's primary profile.

The response will include up to 50 profiles that belong to the group. If more than 50 profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

groupTypestring Required

Name of the group type associated with the profiles you want to retrieve.

alternateIdTypestring Required

Name of the Alternate Id type associated with the specified Alternate Id.

alternateIdstring Required

The Alternate Id value associated with the Alternate Id type.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Groups/AlternateId?groupType=&alternateIdType=&alternateId=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Groups/AlternateId?groupType=&alternateIdType=&alternateId=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve group profiles by email address

This method will retrieve one or more profiles that are part of a group by using an emailAddress of the group's primary profile.

The response will include up to 50 profiles that belong to the group. If more than 50 profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

groupTypestring Required

Name of the group type present on the primary profile of the group.

emailAddressstring Required

The email address associated with the primary profile of the group, used to retrieve all profiles within the group.

emailTypestring

Name of the email type associated with the specified email address. This allows you to filter the results to a specific email type.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Groups/Email?groupType=&emailAddress=&emailType=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Groups/Email?groupType=&emailAddress=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve group profiles by group name

This method will retrieve one or more profiles that are part of a group by using the groupName and groupType combination of the group's primary profile.

The response will include up to 50 profiles that belong to the group. If more than 50 profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

groupTypestring Required

Name of the group type associated with the desired profiles to retrieve.

groupNamestring Required

The name of the group associated with the specified group type on the primary profile of the group.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Groups?groupType=&groupName=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Groups?groupType=&groupName=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve group profiles by phone number

This method will retrieve one or more profiles that are part of a group by using the phoneNumber of a primary profile of the group.

The response will include up to 50 profiles that belong to the group. If more than 50 profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

groupTypestring Required

Name of the group type present on the primary profile of the group.

phoneNumberstring Required

The phone number associated with the primary profile of the group, used to retrieve all profiles within the group.

phoneTypestring

Name of the phone type associated with the specified phone number. This allows you to filter the results to a specific phone type.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Groups/Phone?groupType=&phoneNumber=&phoneType=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Groups/Phone?groupType=&phoneNumber=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Retrieve group profiles by profile id

This method will retrieve one or more profiles that are part of a group by using the profileId of the group’s primary profile.

The response will include up to 50 profiles that belong to the group. If more than 50 profiles are found, the API returns a 403-Forbidden.

The response will include all active consents, custom fields, groups, tags, and preferences for which you have appropriate permissions.

Header Parameters

Authorizationstring Required

Authorization token

Query Parameters

groupTypestring Required

Name of the group type present on the primary profile of the group.

impliedboolean

Boolean flag, when set to true, returns both implied and expressed preferences. Expressed preferences are explicitly stated by individuals, while implied preferences are inherited from the parent Filter when no explicit preference is provided. The Match Type field on a preference record indicates whether a preference is expressed or implied. This distinction is applicable only when the Preference Propagation feature is enabled in your account. Otherwise, all preferences are outpu...

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

Profile Id associated with a primary profile of the group.

Response

200
Object

Response Attributes

Consentsarray

A collection of consents associated with the User Profile.

Show child attributes

CustomFieldsarray

A collection of Custom Fields associated with the profile.

Show child attributes

Groupsarray

A collection of Groups associated with the profile.

Show child attributes

ProfileTagsarray

A collection of Tags associated with the profile.

Show child attributes

Addressesarray

A collection of mailing addresses associated with the profile. The address collection can also include any preferences and consents associated with it.

Show child attributes

Emailsarray

A collection of email addresses associated with the profile. The email collection can also include any preferences and consents associated with it.

Show child attributes

PhoneNumbersarray

A collection of phone numbers associated with the profile. The phone number collection can also include any preferences and consents associated with it.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile. Profile preferences are tied to the user’s profile. These preferences are not associated with any contact element on the profile.

Show child attributes

ProfileIdinteger (int32)

Read-Only Id associated with the Profile.

IsActiveboolean

Defines whether the item is Active or Inactive.

Editedobject

Read-only system fields returned as part of an API response. These are updated automatically when a profile is created or modified.

Show child attributes

RegistrationConfirmedboolean

An optional field for clients to use at their discretion to accommodate scenarios in which customer profile verification is performed.

CustomerTypestring

An identifier used to classify a person by the type of customer. For example: Retail, Commercial, or Marketing.

PreserveConsentsboolean

Specifies whether to retain the contact element consents or deactivate them. To retain the contact element consents, set the value as True. If set to False, the contact element consents will be deactivated. This setting defaults to True, if not specified.

PreservePreferencesboolean

Specifies whether to retain the preferences or deactivate them. To retain the preferences, set the value as True. If set to False, the preferences will be deactivated. This setting defaults to True, if not specified.

CustomerNameobject

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Read-Only field. 'Complete' if the record has been processed otherwise 'Pending Update'.

ReasonCodestring

An optional parameter that can be passed when deactivating a profile.

AlternateIdsarray

A collection of Additional unique identifiers that can be associated with a profile. For example, customer identifiers from other applications such as Salesforce, Marketo or Facebook can be stored as AlternateIds.

Show child attributes

400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

GET

/{clientId}/Profile/Groups/Primary/{profileId}?groupType=&implied=

Select
1 2 curl --location --globoff 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Groups/Primary/{profileId}?groupType=' \ --header 'Authorization;' \

Response

[
  {
    "Consents": [
      {
        "ConsentType": "sample string 1",
        "ConsentVersion": "sample string 2",
        "Locale": "en_US",
        "ConsentStatus": 2,
        "ReasonCode": "sample string 3",
        "ConsentDate": "sample string 4",
        "ExpirationDate": "sample string 5",
        "Expired": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "UpdatedVersionPending": true,
        "IsActive": true
      }
    ],
    "CustomFields": [
      {
        "Name": "sample string 1",
        "Value": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "Groups": [
      {
        "GroupType": "sample string 1",
        "IsPrimary": true,
        "GroupName": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfileTags": [
      {
        "Name": "1"
      }
    ],
    "Addresses": [
      {
        "AddressPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "AddressType": "sample string 1",
        "IsActive": true,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "CassAddress1": "sample string 1",
        "CassAddress2": "sample string 2",
        "CassCity": "sample string 3",
        "CassStateProvince": "sample string 4",
        "CassPostalCode": "sample string 5",
        "CassStatus": "sample string 6",
        "Country": "sample string 7",
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "Address1": "sample string 18",
        "Address2": "sample string 19",
        "City": "sample string 20",
        "StateProvince": "sample string 21",
        "CountryCode_Numeric": "222",
        "CountryCode_Alpha2": "US",
        "CountryCode_Alpha3": "121",
        "PostalCode": "sample string 22"
      }
    ],
    "Emails": [
      {
        "EmailPreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "EmailAddressType": "sample string 1",
        "EmailAddress": "sample string 2",
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "PhoneNumbers": [
      {
        "PhonePreferences": [
          {
            "ProgramId": "sample string 1",
            "ChannelId": "sample string 2",
            "ConsentAssociations": [
              {
                "ConsentType": "sample string 1",
                "ConsentVersion": "sample string 2",
                "IsActive": true,
                "Locale": "en_US",
                "ReasonCode": "sample string 3"
              }
            ],
            "MatchType": "sample string 3",
            "ReasonCode": "sample string 4",
            "ExpirationDate": "sample string 5",
            "PreferenceStatus": "sample string 6",
            "LastModifiedDate": "sample string 7",
            "UserId": "sample string 8",
            "SourceId": "sample string 9",
            "FilterId": "sample string 10",
            "PreferenceType": 2,
            "FrequencyId": "sample string 11",
            "PreferenceAttributes": [
              {
                "Key": "sample string 1",
                "Value": "sample string 2"
              }
            ],
            "CustomerDate": "sample string 12"
          }
        ],
        "PhoneType": "sample string 1",
        "PhoneNumber": "sample string 2",
        "PhoneNumberNumeric": 1,
        "IsDefault": true,
        "Consents": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "Locale": "en_US",
            "ConsentStatus": 2,
            "ReasonCode": "sample string 3",
            "ConsentDate": "sample string 4",
            "ExpirationDate": "sample string 5",
            "Expired": true,
            "Edited": {
              "CreateDate": "sample string 1",
              "CreatedBy": "sample string 2",
              "ModifiedDate": "sample string 3",
              "ModifiedBy": "sample string 4"
            },
            "UpdatedVersionPending": true,
            "IsActive": true
          }
        ],
        "IsMobile": false,
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        }
      }
    ],
    "ProfilePreferences": [
      {
        "ProgramId": "sample string 1",
        "ChannelId": "sample string 2",
        "ConsentAssociations": [
          {
            "ConsentType": "sample string 1",
            "ConsentVersion": "sample string 2",
            "IsActive": true,
            "Locale": "en_US",
            "ReasonCode": "sample string 3"
          }
        ],
        "MatchType": "sample string 3",
        "ReasonCode": "sample string 4",
        "ExpirationDate": "sample string 5",
        "PreferenceStatus": "sample string 6",
        "LastModifiedDate": "sample string 7",
        "UserId": "sample string 8",
        "SourceId": "sample string 9",
        "FilterId": "sample string 10",
        "PreferenceType": 2,
        "FrequencyId": "sample string 11",
        "PreferenceAttributes": [
          {
            "Key": "sample string 1",
            "Value": "sample string 2"
          }
        ],
        "CustomerDate": "sample string 12"
      }
    ],
    "ProfileId": 1,
    "IsActive": true,
    "Edited": {
      "CreateDate": "sample string 1",
      "CreatedBy": "sample string 2",
      "ModifiedDate": "sample string 3",
      "ModifiedBy": "sample string 4"
    },
    "RegistrationConfirmed": true,
    "CustomerType": "sample string 1",
    "PreserveConsents": true,
    "PreservePreferences": true,
    "CustomerName": {
      "FirstName": "sample string 1",
      "MiddleName": "sample string 2",
      "LastName": "sample string 3",
      "Prefix": "",
      "Suffix": "sample string 4"
    },
    "DefaultLocale": "sample string 2",
    "UpdateStatus": "sample string 3",
    "ReasonCode": "sample string 4",
    "AlternateIds": [
      {
        "AlternateIdType": "sample string 1",
        "AlternateId": "sample string 2",
        "IsActive": true,
        "Edited": {
          "CreateDate": "sample string 1",
          "CreatedBy": "sample string 2",
          "ModifiedDate": "sample string 3",
          "ModifiedBy": "sample string 4"
        },
        "AlternateIdTypeLink": 1
      }
    ]
  }
]
Was this section helpful?

What made this section unhelpful for you?

Archive preferences

This method allows you to deactivate preferences on a profile across one or more Filters. You can deactivate preferences that are simply tied to the profile or preferences that are associated with contact elements.

To deactivate all preferences across all filters on a profile, simply set the GlobalDeactivate parameter to true. Deactivated preferences are archived and are no longer returned via the MyPreferences API.

You can create a segment to retrieve archived preferences using the MyPreferences Bulk Export API.

Header Parameters

Authorizationstring Required

Authorization token

Path Parameters

clientIdstring Required

This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.

profileIdinteger (int32)Required

Id associated with the profile.

Body Parameters

GlobalDeactivateboolean

If set to true, deactivates and archives all preferences associated with the Profile and all its contact elements.

Reason_Codestring

Optional parameter that can be used to store the reason for deactivation.

PhoneNumbersarray

A collection of phone preferences associated with the User Profile that you want to deactivate. All deactivated phone preferences are archived.

Show child attributes

Addressesarray

A collection of mail preferences associated with the User Profile that you want to deactivate. All deactivated address preferences are archived.

Show child attributes

Emailsarray

A collection of email preferences associated with the User Profile that you want to deactivate. All deactivated email preferences are archived.

Show child attributes

ProfilePreferencesarray

A collection of preferences associated with the User Profile that you want to deactivate. All deactivated profile preferences are archived.

Show child attributes

Response

204
Object
400
Object
The request was invalid and cannot be processed. This may be a result of a malformed request. You must update the request before trying again.
401
Object
Authentication credentials are missing or incorrect. You must verify your ClientId, UserId, and Authorization Scheme before trying again.
403
Object
The authentication credentials were insufficient to grant access to the requested resource. In most cases, your user may not have the appropriate permissions to access the requested resource. Verify User Group permissions for your user before trying again.
404
Object
The requested resource cannot be found. Most errors in this category are returned when a resource specified on the URL path is not found. In certain instances, it is also returned when a parameter specified in the request body is also not found. See error description for more details.
503
Object
The server encountered an unexpected condition that prevented it from fulfilling the request. Notify PossibleNOW Support if it’s a continuous occurrence.
Was this section helpful?

What made this section unhelpful for you?

PUT

/{clientId}/Profile/Preferences/{profileId}/Archive

Select
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 curl --location --globoff --request PUT 'https://pm.mypreferences.com/Profiles/v2/{clientId}/Profile/Preferences/{profileId}/Archive' \ --header 'Authorization;' \ --data '{ "GlobalDeactivate": true, "Reason_Code": "sample string 1", "PhoneNumbers": [ { "PhoneType": "sample string 1", "PhoneNumber": "sample string 2", "PhoneNumberNumeric": null, "FilterId": "sample string 4", "Reason_Code": "sample string 5" } ], "Addresses": [ { "Address1": "sample string 1", "Address2": "sample string 2", "City": "sample string 3", "StateProvince": "sample string 4", "CountryCode_Numeric": "sample string 5", "CountryCode_Alpha2": "sample string 6", "CountryCode_Alpha3": "sample string 7", "PostalCode": "sample string 8", "AddressType": "sample string 9", "FilterId": "sample string 10", "Reason_Code": "sample string 11" } ], "Emails": [ { "EmailAddressType": "sample string 1", "EmailAddress": "sample string 2", "FilterId": "", "Reason_Code": "sample string 3" } ], "ProfilePreferences": [ { "CustomerType": "sample string 1", "FilterId": "sample string 2", "Reason_Code": "sample string 3" } ] }'

Response

Was this section helpful?

What made this section unhelpful for you?

Bulk API

The MyPreferences 3.0 Bulk API is a powerful and efficient asynchronous RESTful API that serves as a robust conduit for seamless data transfer between MyPreferences and various external systems. It ensures that you can effortlessly manage and exchange large datasets, streamlining the process of integrating zero-party data across your technology ecosystem.

One of the primary advantages of the Bulk API lies in its ability to enable near-real time synchronization of customer data. This means that any updates or changes made within MyPreferences or other connected cloud-based or on-premise systems in your enterprise are swiftly propagated and reflected in the interconnected systems. As a result, your organization can maintain a consistent, up-to-date, and comprehensive view of customer data, which is essential for delivering personalized and tailored experiences to your customers.

Base URL

Production:

https://pm.mypreferences.com/Profiles/v2

Sandbox:

https://pmstg.mypreferences.com/Profiles/v2

Language Box