Upload Customer List - Markifact

Add, remove or replace the hashed records in a Microsoft Ads customer list audience for Customer Match. Hash emails and phone numbers with SHA-256 after lowercasing and trimming. Up to 1000 records per run. Create the list first with microsoft_ads_create_audience.


App	Microsoft Ads
Operation ID	`microsoft_ads_upload_customer_list`
Type	Action
Connection	`microsoft_ads` (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`account`	object or array of object or MicrosoftAdsAccountItem or string or integer	Yes	-	Microsoft Ads account that owns the customer list.
`audience_id`	string or integer	Yes	-	ID of the customer list audience to fill. Create it first with microsoft_ads_create_audience using type CustomerList.
`action_type`	enum (`Add`, `Remove`, `Replace`)	Yes	-	Add appends the records, Remove takes them out, Replace swaps the entire list for what is supplied.
`item_sub_type`	enum (`Email`, `CRM`, `Phone`)	Yes	-	Which identifier the records are. All records in one run must match.
`items`	string or array of string	Yes	-	The hashed records, as a list or one per line. Hash with SHA-256 after lowercasing and trimming, and never send plain text. Up to 1000 per run.
`accept_customer_match_terms`	boolean	No	-	Accepts Microsoft’s Customer Match terms as part of this upload, which otherwise has to be done in the web interface. Leaving it unset keeps whatever was accepted there, and setting it false rejects the terms and fails the upload.

MicrosoftAdsAccountItem

Field	Type	Required	Default	Description
`value`	string	Yes	-
`label`	string	Yes	-
`customerId`	string	No	-	The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID.

Output

Type: Dict Returns how many records were submitted. Rejected records raise an error. Fields: audience_id, action_type, submitted