---
title: "upload_contact_list_csv_audience. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/upload_contact_list_csv_audience
description: "Upload a list of individual CONTACTS (people) as a Contact List CSV and create a CONTACT_LIST audience on the Metadata platform. Writes tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# upload_contact_list_csv_audience

Upload a list of individual CONTACTS (people) as a Contact List CSV and create a CONTACT_LIST audience on the Metadata platform.

Writes [audiences](https://metadata.io/developers/tools/#cat-audiences)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `audience_name` | string | required | Name for the new contact list audience (required). |
| `contacts` | array |   | Inline array of contact objects (optional). Each object represents one person/contact with fields: email (required), firstname, lastname, jobtitle, employeecompany, country, appleidfa, googleaid. Minimum 300 contacts, maximum 300,000 contacts. MUTUALLY EXCLUSIVE with `contacts_source_csv_url` — prov |
| `contacts_source_csv_url` | string |   | Public URL of a contacts CSV file with header EXACTLY `email,firstname,lastname,jobtitle,employeecompany,country,appleidfa,googleaid` (case-insensitive). The MCP server downloads, validates, and uploads the file. Use this when the user attached a CSV to the chat — the URL is surfaced via `AudienceBr |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other audiences tools:

- [archive_audience](https://metadata.io/developers/tools/archive_audience) Destructive
- [create_audience_from_segment](https://metadata.io/developers/tools/create_audience_from_segment) Writes
- [create_bombora_audience](https://metadata.io/developers/tools/create_bombora_audience) Writes
- [create_csv_upload_linkedin_native_audience](https://metadata.io/developers/tools/create_csv_upload_linkedin_native_audience) Writes
- [create_facebook_native_criteria_audience](https://metadata.io/developers/tools/create_facebook_native_criteria_audience) Writes
- [create_firmographic_audience](https://metadata.io/developers/tools/create_firmographic_audience) Writes
- [create_g2_intent_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_dynamic_audience) Writes
- [create_g2_intent_linkedin_native_dynamic_audience](https://metadata.io/developers/tools/create_g2_intent_linkedin_native_dynamic_audience) Writes

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)