BulkUpsertExtensions

BulkUpsertExtensions

BulkUpsertExtensions is used for inserting new contact extensions and updating existing contact extensions in the master_contact_extensions table.

This method takes a column list and a contactDatas array. All data will be processed according to the columns list.

contact_key and address columns in master_contact_extensions table are mandatory and unique across all the extensions.
So, for all items in the request body, contact_key and address are mandatory parameters.

The users can update name, permission, channel columns in master_contact_extensions table directly. To update contact_key or address columns, provide the values with new_contact_key or new_address properties.

Important Notes

• The insertIfNotExists property controls whether new extension records can be inserted into master_contact_extensions table. However, insert operations are not allowed when new_contact_key or new_address properties are present in the same request. These operations must be separated into different requests.
• If using new_address, the channel column must also be included in the columns list to properly validate the address format
• The endpoint processes data based on your account's brand configuration
• All data validation is performed before any updates are made
• Failed records will be reported in the response's errors array
• The endpoint requires authentication and proper API permissions
• When using name column, it must match an existing extension type configured in your account for the given channel