> ## 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.

# Create Audience

> Creates a DV360 Customer Match audience from emails, phone numbers (hashed automatically), or mobile device IDs

Creates a DV360 Customer Match audience from emails, phone numbers (hashed automatically), or mobile device IDs. Target it via dv360\_edit\_line\_item\_targeting; audiences may take up to 12 hours to populate.

|                       |                         |
| --------------------- | ----------------------- |
| **App**               | DV360                   |
| **Operation ID**      | `dv360_create_audience` |
| **Type**              | Action                  |
| **Connection**        | `dv360` (required)      |
| **Credits per run**   | 2                       |
| **Agent / MCP tool**  | Yes                     |
| **Requires approval** | Yes (write operation)   |

## Inputs

| Field                        | Type                       | Required | Default | Description                                                                                                                                                                                                                                                   |
| ---------------------------- | -------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `account`                    | DynamicAccount             | Yes      | -       | Select the DV360 advertiser to create the audience under.                                                                                                                                                                                                     |
| `audience_type`              | string or SelectableOption | Yes      | -       | Customer Match audience type (the only types the API can create). Options: 'CUSTOMER\_MATCH\_CONTACT\_INFO' (emails / phone numbers), 'CUSTOMER\_MATCH\_DEVICE\_ID' (mobile advertising IDs).                                                                 |
| `name`                       | string                     | Yes      | -       | Display name for the audience.                                                                                                                                                                                                                                |
| `description`                | string                     | No       | -       | Optional description of the audience.                                                                                                                                                                                                                         |
| `membership_duration_days`   | integer                    | Yes      | -       | How many days members stay in the audience after being added (1-540).                                                                                                                                                                                         |
| `emails`                     | string or array of string  | No       | -       | Email addresses for CUSTOMER\_MATCH\_CONTACT\_INFO audiences, as a list or newline/comma separated text. Plain emails are normalized (whitespace removed, lowercased) and SHA-256 hashed automatically; already-hashed 64-char hex values are passed through. |
| `phone_numbers`              | string or array of string  | No       | -       | Phone numbers for CUSTOMER\_MATCH\_CONTACT\_INFO audiences in E.164 format with country code (e.g. +14155550101), as a list or newline/comma separated text. Hashed automatically; already-hashed values are passed through.                                  |
| `mobile_device_ids`          | string or array of string  | No       | -       | Mobile advertising IDs (IDFA / AAID) for CUSTOMER\_MATCH\_DEVICE\_ID audiences, as a list or newline/comma separated text. Not hashed.                                                                                                                        |
| `app_id`                     | string                     | No       | -       | App ID matching the type of the mobile device IDs (for example an iOS App Store ID or Android package name). Only for CUSTOMER\_MATCH\_DEVICE\_ID audiences.                                                                                                  |
| `consent_ad_user_data`       | string or SelectableOption | No       | -       | Optional consent for ad user data. Options: 'CONSENT\_STATUS\_GRANTED'. DV360 rejects uploads with denied consent, so leave unset if consent is not specified.                                                                                                |
| `consent_ad_personalization` | string or SelectableOption | No       | -       | Optional consent for ad personalization. Options: 'CONSENT\_STATUS\_GRANTED'.                                                                                                                                                                                 |

### SelectableOption

| Field   | Type   | Required | Default | Description |
| ------- | ------ | -------- | ------- | ----------- |
| `value` | string | Yes      | -       |             |
| `label` | string | Yes      | -       |             |

## Output

**Type**: `Dict`

Returns the created audience.

**Fields**: `audience_id`, `audience_name`, `audience_type`