API explorerChangelog
Overview

Sections

Theme switcher

Create 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

ProfileIdnumber

System-generated unique identifier associated with the profile. Read-only.

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 based on specific criteria. For example, it can represent their buying stage (prospect, lead, customer), firmographics (industry, company size), or any other criteria.

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.

Default value
true
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.

Default value
true
CustomerNameobject

Name fields associated with the profile.

Show child attributes

DefaultLocalestring

Default Locale for the profile.

UpdateStatusstring

Shows 'Complete' if the record is processed, otherwise 'Pending Update.' Read-only.

ReasonCodestring

An optional parameter used when deactivating a profile to specify the reason for deactivation.

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

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

Consentsarray

A collection of consents associated with the 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

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".

Response Attributes

AlternateIdstring

An additional identifier which uniquely identifies the profile.

Min length
1
Max length
512
AlternateIdTypestring

Name of the AlternateIdType to which the AlternateId can be associated.

ProfileIdinteger

System-generated unique identifier associated with the profile. Read-only.

UpdateStatusstring

Shows 'Complete' if the record is processed, otherwise 'Pending Update.' Read-only.

SubmittedUtcTimestring

DateTime when the request was submitted.

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

/

Select
1

Response

Was this section helpful?

What made this section unhelpful for you?