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

> Creates a DV360 campaign under an advertiser with goal, performance target, flight dates, and frequency cap

Creates a DV360 campaign under an advertiser with goal, performance target, flight dates, and frequency cap. Amounts are entered in the advertiser's currency and converted to DV360 micros automatically.

|                       |                         |
| --------------------- | ----------------------- |
| **App**               | DV360                   |
| **Operation ID**      | `dv360_create_campaign` |
| **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 campaign under.                                                                                                                                                                                                                          |
| `campaign_name`                 | string                     | Yes      | -                                        | Display name of the campaign. Max 240 bytes.                                                                                                                                                                                                                                       |
| `status`                        | string or SelectableOption | No       | `{'value': 'PAUSED', 'label': 'Paused'}` | Status when the campaign is created: ACTIVE or PAUSED. Default: PAUSED.                                                                                                                                                                                                            |
| `campaign_goal_type`            | string or SelectableOption | Yes      | -                                        | Campaign goal: APP\_INSTALL (drive app installs), BRAND\_AWARENESS (raise awareness), OFFLINE\_ACTION (drive offline or in-store sales), or ONLINE\_ACTION (drive online actions or visits).                                                                                       |
| `performance_goal_type`         | string or SelectableOption | Yes      | -                                        | Performance goal metric. Money goals (use performance\_goal\_amount): CPM, CPC, CPA, CPIAVC, CPE, CPV, VCPM. Percentage goals (use performance\_goal\_percentage): CTR, VIEWABILITY, CLICK\_CVR, IMPRESSION\_CVR, VTR, AUDIO\_CR, VIDEO\_CR. OTHER uses performance\_goal\_string. |
| `performance_goal_amount`       | number                     | No       | -                                        | Goal amount in the advertiser's currency (for example 2.5 for a \$2.50 CPM). Required for money performance goals; converted to DV360 micros automatically.                                                                                                                        |
| `performance_goal_percentage`   | number                     | No       | -                                        | Goal percentage (for example 70 for 70%). Required for percentage performance goals; converted to DV360 percentage micros automatically.                                                                                                                                           |
| `performance_goal_string`       | string                     | No       | -                                        | Key performance indicator text. Required when performance\_goal\_type is OTHER.                                                                                                                                                                                                    |
| `start_date`                    | string                     | Yes      | -                                        | Planned flight start date as YYYY-MM-DD, in the advertiser's timezone.                                                                                                                                                                                                             |
| `end_date`                      | string                     | No       | -                                        | Optional planned flight end date as YYYY-MM-DD. Must be on or after start\_date.                                                                                                                                                                                                   |
| `planned_spend`                 | number                     | No       | -                                        | Optional planned spend for the flight in the advertiser's currency; converted to micros automatically. Informational only; DV360 does not enforce it.                                                                                                                              |
| `unlimited_frequency_cap`       | boolean                    | No       | `True`                                   | When true (default), no campaign-level frequency cap. Set false to cap impressions per user with the frequency\_cap\_\* fields.                                                                                                                                                    |
| `frequency_cap_max_impressions` | integer                    | No       | -                                        | Maximum impressions per user for the chosen time window. Required when unlimited\_frequency\_cap is false.                                                                                                                                                                         |
| `frequency_cap_time_unit`       | string or SelectableOption | No       | -                                        | Frequency cap window unit: LIFETIME, MONTHS, WEEKS, DAYS, HOURS, or MINUTES. Required when unlimited\_frequency\_cap is false.                                                                                                                                                     |
| `frequency_cap_time_unit_count` | integer                    | No       | -                                        | How many time units the window lasts (for example 1 WEEK). Required when unlimited\_frequency\_cap is false, except for LIFETIME.                                                                                                                                                  |

### SelectableOption

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

## Output

**Type**: `Dict`

Returns the created DV360 campaign details.

**Fields**: `campaign_id`, `campaign_name`, `entity_status`, `advertiser_id`, `campaign`