Links

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 user point 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 user point
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>