> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Customer List

> Add, remove or replace the hashed records in a Microsoft Ads customer list audience for Customer Match

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`                     | DynamicAccount                    | 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. |

## Output

**Type**: `Dict`

Returns how many records were submitted. Rejected records raise an error.

**Fields**: `audience_id`, `action_type`, `submitted`