Stage
The staging step is the second step in the import process where the data gets staged for initial validation.
The response for each staging request also includes the total number of records received, records that were validated successfully, and the records that failed the initial validation process.
The ValidationFailed count represents the number of records that failed validation during the data staging process. User permissions are also validated during the staging process. Records
that fail to validate against the Profile, Preference and Channel-level permissions get added to
the ValidationFailed count.
The staging step can be performed multiple times prior to executing an import, allowing you to stage large sets of data over time, as long as the access token remains active. For instance, you can initiate an import early in the morning and stage data at multiple intervals throughout several hours. When the execute request is triggered, the staged data will be imported into MyPreferences.
Header Parameters
Authorization token
Path Parameters
This is your organization’s MyPreferences account Id. A 404 is returned if this value is invalid.
Access token returned from InitiateBulkImport call. A 401 is returned if this value is invalid.
Body Parameters
Collection of BulkUserProfilePreferences. The parent JSON schema which comprises of multiple object collections, each of which can be used for importing data.
Show child attributes
Response
Response Attributes
Total number of records that were staged. This number is the combined value of all of the records that were added during the staging phase of the import.
Total Number of records that were validated successfully during the staging phase and are ready for execution. This number is the combined value of all records submitted across various requests during the staging phase of the import.
Number of records that failed validation during the staging process. Any records that fail validation will not be imported during the execution phase.
Number of records that have been imported into MyPreferences. During the staging process, this value will always return 0.
Total amount of records that have been marked as pending to be processed during the staging phase. This number is the combined value of all of the requests that were received during the staging phase of the import.
Total number of records that encountered exceptions during the import execution. During the staging process, this value will always return 0.
Number of records that were not honored by the system during the import process. During the staging process, this value will always return 0.
Token created by the initiate method used to stage, execute, and retrieve import status and failed records.
Returns the current state of the import. 'Initiated', 'Staging', 'Queued', 'Processing', 'Completed', or 'Failed'.
Date when the access token will expire. Default expiration time is 12 hours.
Name associated with the bulk import operation.
Determines the number of days for retaining staged data before it is permanently deleted. If not specified, it defaults to 3 days. The staging duration cannot exceed 10 days.
Specifies whether to add or delete profiles. Supported values are "Add" and "Delete".
An optional parameter that can be used as a matching identifier in the absence of a Profile ID. Currently, AlternateIdType is the only supported match criteria.
TypeName associated with the match criteria. Specify the name of an AlternateIdType configured in your account since AlternateIdType is the only supported Match Criteria.
If set to true, existing AlternateIds that are NOT included in the import will be deactivated. Default value is false.
If set to true, existing profile contact elements that are NOT included in the import will be deactivated along with any preferences associated with them. Default value is false.
If set to true, existing CustomFields that are NOT included in the import will be deleted. Default value is false.
If set to true, existing Groups that are NOT included in the import, will be deactivated. Default value is false.
If set to true, existing Tags that are NOT included in the import, will be deleted. Default value is false.
A boolean flag, when set to true, permits adding an older version of a consent to the profile, provided that a more recent version of the consent is not already present.
What made this section unhelpful for you?
Response
What made this section unhelpful for you?