Create Audience - Markifact

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