UserPoint API

The UserPoint API allows to retrieve, create, update or delete all data related to a single UserPoint.

General description

The endpoint is formatted as follows:

/v1/datamarts/<DATAMART_ID>/user_points/<USER_POINT_SELECTOR>/<DOCUMENT_TYPE>/<DOCUMENT_SELECTOR>

where

• <USER_POINT_SELECTOR> allows to select a UserPoint based on any of its identifiers

Possible values are:

<USER_POINT_ID> or user_point_id=<USER_POINT_ID>
user_agent_id=<USER_AGENT_ID>
compartment_id=<COMPARTMENT_ID>,user_account_id=<USER_ACCOUNT_ID>
email_hash=<EMAIL_HASH>

• <DOCUMENT_TYPE> designates the type of data that will be addressed

Possible values are:

user_identifiers
user_profiles
user_activities
user_choices
user_scenarios
user_segments

• <DOCUMENT_SELECTOR> allows to select a particular document on the UserPoint

As each document is identified by a different identifier, possible values depend on the type of document previously selected. It is also optional: use it if you want to get, update or delete a particular document.

user_profiles/compartment_id=<COMPARTMENT_ID>
user_profiles/compartment_id=<COMPARTMENT_ID>/user_account_id=<USER_ACCOUNT_ID>
user_choices/processing_id=<PROCESSING_ID>
user_scenarios/scenario_id=<SCENARIO_ID>
user_segments/audience_segment_id=<SEGMENT_ID>