# Pinterest Ads

> Manage Pinterest advertising campaigns, ad groups, ads, conversion tags and performance reports.

App · 24 actions. Web page: https://docs.lodol.com/docs/integrations/pinterest-ads

## Actions

### Create ad account

Create an ad account. Each ad account has its own country, currency and time zone.

**Inputs**

- Country (`country`, text): Country ID from ISO 3166-1 alpha-2. One of: `AD` (Andorra), `AE` (United Arab Emirates), `AF` (Afghanistan), `AG` (Antigua & Barbuda), `AI` (Anguilla), `AL` (Albania), `AM` (Armenia), `AO` (Angola), `AQ` (Antarctica), `AR` (Argentina), and 238 more.
- Currency (`currency`, text): Currency Codes from ISO 4217. One of: `UNK`, `USD`, `GBP`, `CAD`, `EUR`, `AUD`, `NZD`, `SEK`, `ILS`, `CHF`, and 17 more.
- Name (`name`, text): Ad account name.
- Owner user id (`owner_user_id`, text): Advertiser's owning user ID.
- Time zone (`time_zone`, text): The time zone of the ad account, in IANA format (e.g., "America/Los_Angeles"). Adding your local time zone lets you view your campaigns and ad reporting in your preferred time zone. Future reports will be available in both your local time zone and default UTC time zone. Historical data takes 1-2 months to backfill. Your billing and order lines will remain in UTC.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "country": "AD",
    "created_time": 1,
    "currency": "UNK",
    "id": "example",
    "name": "example",
    "owner": {
      "id": "example",
      "username": "example"
    },
    "permissions": [],
    "time_zone": "example",
    "updated_time": 1
  }
}
```

### Create ad groups

Create one or more ad groups. All ads in an ad group share its budget, bid, run dates, targeting and placement.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Request body (`request_body`, list, required): Request body.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "items": []
  }
}
```

### Create ads

Create one or more ads. Each ad needs an ad group, a creative type and the Pin it promotes.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Request body (`request_body`, list, required): Request body.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "items": []
  }
}
```

### Create campaigns

Create one or more campaigns.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Request body (`request_body`, list, required): Request body for batch campaign create.

**Outputs**

- `data` (object): Response model for batch campaign write operations.

**Example output**

```json
{
  "data": {
    "items": []
  }
}
```

### Create conversion tag

Create a conversion tag, also called a Pinterest tag, with the option to turn on enhanced match.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Aem db enabled (`aem_db_enabled`, true/false): Whether Automatic Enhanced Match birthdate is enabled. See Enhanced match for more information. Default: `false`.
- Aem enabled (`aem_enabled`, true/false): Whether Automatic Enhanced Match email is enabled. See Enhanced match for more information. Default: `false`.
- Aem external id enabled (`aem_external_id_enabled`, true/false): Whether Automatic Enhanced Match location is enabled. See Enhanced match for more information. Default: `false`.
- Aem fnln enabled (`aem_fnln_enabled`, true/false): Whether Automatic Enhanced Match name is enabled. See Enhanced match for more information. Default: `false`.
- Aem ge enabled (`aem_ge_enabled`, true/false): Whether Automatic Enhanced Match gender is enabled. See Enhanced match for more information. Default: `false`.
- Aem loc enabled (`aem_loc_enabled`, true/false): Whether Automatic Enhanced Match location is enabled. See Enhanced match for more information. Default: `false`.
- Aem ph enabled (`aem_ph_enabled`, true/false): Whether Automatic Enhanced Match phone is enabled. See Enhanced match for more information. Default: `false`.
- Md frequency (`md_frequency`, number): Metadata ingestion frequency. Default: `1`.
- Name (`name`, text, required): Conversion tag name.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "ad_account_id": "example",
    "code_snippet": "example",
    "configs": {
      "aem_db_enabled": false,
      "aem_enabled": false,
      "aem_external_id_enabled": false,
      "aem_fnln_enabled": false,
      "aem_ge_enabled": false,
      "aem_loc_enabled": false,
      "aem_ph_enabled": false,
      "md_frequency": 1.0,
      "no_code_capi_domains": []
    },
    "enhanced_match_status": "UNKNOWN",
    "id": "example",
    "last_fired_time_ms": 1.0,
    "name": "example",
    "status": "ACTIVE",
    "version": "example"
  }
}
```

### Get ad

Get one ad by its ID. If its Pin was rejected, the result includes the reasons.

**Inputs**

- Ad id (`ad_id`, text, required): Ad id.
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "ad_account_id": "example",
    "ad_group_id": "example",
    "android_deep_link": "example",
    "campaign_id": "example",
    "carousel_android_deep_links": [],
    "carousel_destination_urls": [],
    "carousel_ios_deep_links": [],
    "carting_platform_type": 1,
    "carting_products": [],
    "click_tracking_url": "example",
    "collection_items_destination_url_template": "example",
    "collections_header_type": "SHOP_THIS_COLLECTION",
    "created_time": 1,
    "creative_type": "REGULAR",
    "customizable_cta_type": "GET_OFFER",
    "destination_url": "example",
    "disclosure_type": "NO_DISCLOSURE",
    "disclosure_url": "example",
    "grid_click_type": "CLOSEUP",
    "id": "example",
    "ios_deep_link": "example",
    "is_carting": false,
    "is_collage_accepted_terms": false,
    "is_collage_single_destination": false,
    "is_pin_deleted": false,
    "is_removable": false,
    "lead_form_id": "example",
    "name": "example",
    "pin_id": "example",
    "quiz_pin_data": {
      "questions": [],
      "results": [],
      "tie_breaker_custom_result": {
        "android_deep_link": "example",
        "destination_url": "example",
        "ios_deep_link": "example",
        "organic_pin_id": "example",
        "result_id": 1.0
      },
      "tie_breaker_type": "RANDOM"
    },
    "rejected_reasons": [],
    "rejection_labels": [],
    "review_status": "OTHER",
    "status": "ACTIVE",
    "summary_status": "APPROVED",
    "tracking_urls": {
      "audience_verification": [],
      "buyable_button": [],
      "click": [],
      "engagement": [],
      "impression": []
    },
    "type": "example",
    "updated_time": 1,
    "view_tracking_url": "example"
  }
}
```

### Get ad account

Get one ad account.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "country": "AD",
    "created_time": 1,
    "currency": "UNK",
    "id": "example",
    "name": "example",
    "owner": {
      "id": "example",
      "username": "example"
    },
    "permissions": [],
    "time_zone": "example",
    "updated_time": 1
  }
}
```

### Get ad account analytics

Get performance analytics for an ad account over a date range.

**Inputs**

- Start date (`start_date`, date, required): Start date.
- End date (`end_date`, date, required): End date.
- Columns (`columns`, list, required): Columns. One or more of: `SPEND_IN_MICRO_DOLLAR` (Spend in micro dollar), `PAID_IMPRESSION` (Paid impression), `SPEND_IN_DOLLAR` (Spend in dollar), `CPC_IN_MICRO_DOLLAR` (Cpc in micro dollar), `ECPC_IN_MICRO_DOLLAR` (Ecpc in micro dollar), `ECPC_IN_DOLLAR` (Ecpc in dollar), `CTR`, `ECTR`, `OUTBOUND_CTR_1` (Outbound ctr 1), `CAMPAIGN_NAME` (Campaign name), and 175 more.
- Granularity (`granularity`, text, required): Specifies the time interval at which analytics data is broken down. Determines how metrics are grouped within the requested date range. **Note:** The HOUR enum no longer provides data for conversion metrics, but it still returns data for non-conversion metrics. All other enums are unchanged. One of: `TOTAL`, `DAY`, `HOUR`, `WEEK`, `MONTH`.
- Click window days (`click_window_days`, number): Click window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- Engagement window days (`engagement_window_days`, number): Engagement window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- View window days (`view_window_days`, number): View window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `1`.
- Conversion report time (`conversion_report_time`, text): Conversion report time. One of: `TIME_OF_AD_ACTION` (Time of ad action), `TIME_OF_CONVERSION` (Time of conversion). Default: `TIME_OF_AD_ACTION`.
- Reporting timezone (`reporting_timezone`, text): Specify the timezone to be applied for the reporting. One of: `PINTEREST_TIME_ZONE` (Pinterest time zone), `AD_ACCOUNT_TIME_ZONE` (Ad account time zone).
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (list): Pinterest Ads response data.

**Example output**

```json
{
  "data": []
}
```

### Get ad analytics

Get performance analytics for ads in an ad account over a date range.

**Inputs**

- Pin ids (`pin_ids`, list): Pin ids.
- Start date (`start_date`, date, required): Start date.
- End date (`end_date`, date, required): End date.
- Ad ids (`ad_ids`, list): Ad ids.
- Columns (`columns`, list, required): Columns. One or more of: `SPEND_IN_MICRO_DOLLAR` (Spend in micro dollar), `PAID_IMPRESSION` (Paid impression), `SPEND_IN_DOLLAR` (Spend in dollar), `CPC_IN_MICRO_DOLLAR` (Cpc in micro dollar), `ECPC_IN_MICRO_DOLLAR` (Ecpc in micro dollar), `ECPC_IN_DOLLAR` (Ecpc in dollar), `CTR`, `ECTR`, `OUTBOUND_CTR_1` (Outbound ctr 1), `CAMPAIGN_NAME` (Campaign name), and 175 more.
- Granularity (`granularity`, text, required): Specifies the time interval at which analytics data is broken down. Determines how metrics are grouped within the requested date range. **Note:** The HOUR enum no longer provides data for conversion metrics, but it still returns data for non-conversion metrics. All other enums are unchanged. One of: `TOTAL`, `DAY`, `HOUR`, `WEEK`, `MONTH`.
- Click window days (`click_window_days`, number): Click window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- Engagement window days (`engagement_window_days`, number): Engagement window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- View window days (`view_window_days`, number): View window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `1`.
- Conversion report time (`conversion_report_time`, text): Conversion report time. One of: `TIME_OF_AD_ACTION` (Time of ad action), `TIME_OF_CONVERSION` (Time of conversion). Default: `TIME_OF_AD_ACTION`.
- Campaign ids (`campaign_ids`, list): Campaign ids.
- Reporting timezone (`reporting_timezone`, text): Specify the timezone to be applied for the reporting. One of: `PINTEREST_TIME_ZONE` (Pinterest time zone), `AD_ACCOUNT_TIME_ZONE` (Ad account time zone).
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (list): Pinterest Ads response data.

**Example output**

```json
{
  "data": []
}
```

### Get ad group

Get one ad group by its ID.

**Inputs**

- Ad group id (`ad_group_id`, text, required): Ad group id.
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "ad_account_id": "example",
    "auto_targeting_enabled": false,
    "bid_in_micro_currency": 1,
    "bid_multiplier": 1.0,
    "bid_strategy_type": "AUTOMATIC_BID",
    "billable_event": "CLICKTHROUGH",
    "budget_in_micro_currency": 1,
    "budget_type": "DAILY",
    "campaign_id": "example",
    "conversion_learning_mode_type": "NOT_ACTIVE",
    "created_time": 1,
    "customer_segment_id": "example",
    "dca_assets": {},
    "end_time": 1,
    "ext_features": {
      "enabled": []
    },
    "feed_profile_id": "example",
    "id": "example",
    "is_creative_optimization": false,
    "is_local_inventory": false,
    "lifetime_frequency_cap": 1,
    "local_inventory_radius_in_miles": 1.0,
    "name": "example",
    "optimization_goal_metadata": {
      "conversion_tag_v3_goal_metadata": {
        "attribution_windows": {
          "click_window_days": 1,
          "engagement_window_days": 1,
          "view_window_days": 1
        },
        "conversion_event": "PAGE_VISIT",
        "conversion_tag_id": "example",
        "cpa_goal_value_in_micro_currency": "example",
        "is_roas_optimized": false,
        "reporting_event": "example"
      },
      "frequency_goal_metadata": {
        "frequency": 1,
        "timerange": "THIRTY_DAY"
      },
      "scrollup_goal_metadata": {
        "scrollup_goal_value_in_micro_currency": "example"
      }
    },
    "pacing_delivery_type": "STANDARD",
    "performance_plus_campaign_settings": {
      "boost_prospecting_ad_group_bid": false,
      "pinner_list_exclusions": []
    },
    "placement_group": "ALL",
    "placement_traffic_type": "ALL",
    "promotion_application_level": "NONE",
    "promotion_id": "example",
    "promotion_ids": [],
    "start_time": 1,
    "status": "ACTIVE",
    "summary_status": "RUNNING",
    "targeting_spec": {
      "AGE_BUCKET": [],
      "APPTYPE": [],
      "AUDIENCE_EXCLUDE": [],
      "AUDIENCE_INCLUDE": [],
      "GENDER": [],
      "GEO": [],
      "GEO_EXCLUDE": [],
      "INTEREST": [],
      "LOCALE": [],
      "LOCATION": [],
      "LOCATION_EXCLUDE": [],
      "MAXIMUM_AGE": "example",
      "MINIMUM_AGE": "example",
      "SHOPPING_RETARGETING": [],
      "TARGETING_STRATEGY": []
    },
    "targeting_template_ids": [],
    "tracking_urls": {
      "audience_verification": [],
      "buyable_button": [],
      "click": [],
      "engagement": [],
      "impression": []
    },
    "type": "example",
    "updated_time": 1
  }
}
```

### Get ad group analytics

Get performance analytics for ad groups in an ad account over a date range.

**Inputs**

- Start date (`start_date`, date, required): Start date.
- End date (`end_date`, date, required): End date.
- Ad group ids (`ad_group_ids`, list, required): Ad group ids.
- Columns (`columns`, list, required): Columns. One or more of: `SPEND_IN_MICRO_DOLLAR` (Spend in micro dollar), `PAID_IMPRESSION` (Paid impression), `SPEND_IN_DOLLAR` (Spend in dollar), `CPC_IN_MICRO_DOLLAR` (Cpc in micro dollar), `ECPC_IN_MICRO_DOLLAR` (Ecpc in micro dollar), `ECPC_IN_DOLLAR` (Ecpc in dollar), `CTR`, `ECTR`, `OUTBOUND_CTR_1` (Outbound ctr 1), `CAMPAIGN_NAME` (Campaign name), and 175 more.
- Granularity (`granularity`, text, required): Specifies the time interval at which analytics data is broken down. Determines how metrics are grouped within the requested date range. **Note:** The HOUR enum no longer provides data for conversion metrics, but it still returns data for non-conversion metrics. All other enums are unchanged. One of: `TOTAL`, `DAY`, `HOUR`, `WEEK`, `MONTH`.
- Click window days (`click_window_days`, number): Click window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- Engagement window days (`engagement_window_days`, number): Engagement window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- View window days (`view_window_days`, number): View window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `1`.
- Conversion report time (`conversion_report_time`, text): Conversion report time. One of: `TIME_OF_AD_ACTION` (Time of ad action), `TIME_OF_CONVERSION` (Time of conversion). Default: `TIME_OF_AD_ACTION`.
- Aggregate report rows (`aggregate_report_rows`, true/false): Aggregate report rows. Default: `false`.
- Reporting timezone (`reporting_timezone`, text): Specify the timezone to be applied for the reporting. One of: `PINTEREST_TIME_ZONE` (Pinterest time zone), `AD_ACCOUNT_TIME_ZONE` (Ad account time zone).
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (list): Pinterest Ads response data.

**Example output**

```json
{
  "data": []
}
```

### Get campaign

Get one campaign by its ID.

**Inputs**

- Campaign id (`campaign_id`, text, required): Campaign id.
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "ad_account_id": "example",
    "bid_options": {
      "age_bucket_multipliers": {
        "AGE_BUCKET": "18-24"
      },
      "app_type_multipliers": {
        "APP_TYPE": "android_mobile"
      },
      "audience_multipliers": {
        "AUDIENCE_ID": "example"
      },
      "freq_bid_multiplier_time_window": "WEEK",
      "frequency_multipliers": {
        "IMPRESSION_COUNT": "example"
      },
      "gender_multipliers": {
        "GENDER": "unknown"
      },
      "placement_multipliers": {
        "PLACEMENT": "SEARCH"
      }
    },
    "created_time": 1,
    "daily_spend_cap": 1,
    "default_ad_group_budget_in_micro_currency": 1,
    "end_time": 1,
    "id": "example",
    "intended_promotion_type": "LEGACY",
    "is_automated_campaign": false,
    "is_campaign_budget_optimization": false,
    "is_carting": false,
    "is_flexible_daily_budgets": false,
    "is_ltv_optimized": false,
    "is_performance_plus": false,
    "is_top_of_search": false,
    "lifetime_spend_cap": 1,
    "name": "example",
    "objective_type": "AWARENESS",
    "order_line_id": "example",
    "performance_plus_campaign_settings": {
      "boost_prospecting_ad_group_bid": false,
      "pinner_list_exclusions": []
    },
    "start_time": 1,
    "status": "ACTIVE",
    "summary_status": "RUNNING",
    "tracking_urls": {
      "audience_verification": [],
      "buyable_button": [],
      "click": [],
      "engagement": [],
      "impression": []
    },
    "type": "example",
    "updated_time": 1
  }
}
```

### Get campaign analytics

Get performance analytics for campaigns in an ad account over a date range.

**Inputs**

- Start date (`start_date`, date, required): Start date.
- End date (`end_date`, date, required): End date.
- Campaign ids (`campaign_ids`, list, required): Campaign ids.
- Columns (`columns`, list, required): Columns. One or more of: `SPEND_IN_MICRO_DOLLAR` (Spend in micro dollar), `PAID_IMPRESSION` (Paid impression), `SPEND_IN_DOLLAR` (Spend in dollar), `CPC_IN_MICRO_DOLLAR` (Cpc in micro dollar), `ECPC_IN_MICRO_DOLLAR` (Ecpc in micro dollar), `ECPC_IN_DOLLAR` (Ecpc in dollar), `CTR`, `ECTR`, `OUTBOUND_CTR_1` (Outbound ctr 1), `CAMPAIGN_NAME` (Campaign name), and 175 more.
- Granularity (`granularity`, text, required): Specifies the time interval at which analytics data is broken down. Determines how metrics are grouped within the requested date range. **Note:** The HOUR enum no longer provides data for conversion metrics, but it still returns data for non-conversion metrics. All other enums are unchanged. One of: `TOTAL`, `DAY`, `HOUR`, `WEEK`, `MONTH`.
- Click window days (`click_window_days`, number): Click window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- Engagement window days (`engagement_window_days`, number): Engagement window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- View window days (`view_window_days`, number): View window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `1`.
- Conversion report time (`conversion_report_time`, text): Conversion report time. One of: `TIME_OF_AD_ACTION` (Time of ad action), `TIME_OF_CONVERSION` (Time of conversion). Default: `TIME_OF_AD_ACTION`.
- Aggregate report rows (`aggregate_report_rows`, true/false): Aggregate report rows. Default: `false`.
- Reporting timezone (`reporting_timezone`, text): Specify the timezone to be applied for the reporting. One of: `PINTEREST_TIME_ZONE` (Pinterest time zone), `AD_ACCOUNT_TIME_ZONE` (Ad account time zone).
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (list): Pinterest Ads response data.

**Example output**

```json
{
  "data": []
}
```

### Get conversion tag

Get one conversion tag.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Conversion tag id (`conversion_tag_id`, text, required): Conversion tag id.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "ad_account_id": "example",
    "code_snippet": "example",
    "configs": {
      "aem_db_enabled": false,
      "aem_enabled": false,
      "aem_external_id_enabled": false,
      "aem_fnln_enabled": false,
      "aem_ge_enabled": false,
      "aem_loc_enabled": false,
      "aem_ph_enabled": false,
      "md_frequency": 1.0,
      "no_code_capi_domains": []
    },
    "enhanced_match_status": "UNKNOWN",
    "id": "example",
    "last_fired_time_ms": 1.0,
    "name": "example",
    "status": "ACTIVE",
    "version": "example"
  }
}
```

### Get page visit conversion tags

List an ad account's page visit conversion tag events.

**Inputs**

- Bookmark (`bookmark`, text): Bookmark.
- Page size (`page_size`, number): Page size. From 1 to 250. Default: `25`.
- Order (`order`, text): Order. One of: `ASCENDING`, `DESCENDING`. Default: `ASCENDING`.
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "bookmark": "example",
    "items": []
  }
}
```

### Get targeting analytics for an ad account

Get performance analytics for an ad account broken down by targeting type, over a date range.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Start date (`start_date`, date, required): Start date.
- End date (`end_date`, date, required): End date.
- Targeting types (`targeting_types`, list, required): Targeting types. One or more of: `KEYWORD`, `APPTYPE`, `GENDER`, `LOCATION`, `PLACEMENT`, `COUNTRY`, `TARGETED_INTEREST` (Targeted interest), `PINNER_INTEREST` (Pinner interest), `AUDIENCE_INCLUDE` (Audience include), `GEO`, and 3 more.
- Columns (`columns`, list, required): Columns. One or more of: `SPEND_IN_MICRO_DOLLAR` (Spend in micro dollar), `PAID_IMPRESSION` (Paid impression), `SPEND_IN_DOLLAR` (Spend in dollar), `CPC_IN_MICRO_DOLLAR` (Cpc in micro dollar), `ECPC_IN_MICRO_DOLLAR` (Ecpc in micro dollar), `ECPC_IN_DOLLAR` (Ecpc in dollar), `CTR`, `ECTR`, `OUTBOUND_CTR_1` (Outbound ctr 1), `CAMPAIGN_NAME` (Campaign name), and 175 more.
- Granularity (`granularity`, text, required): Specifies the time interval at which analytics data is broken down. Determines how metrics are grouped within the requested date range. **Note:** The HOUR enum no longer provides data for conversion metrics, but it still returns data for non-conversion metrics. All other enums are unchanged. One of: `TOTAL`, `DAY`, `HOUR`, `WEEK`, `MONTH`.
- Click window days (`click_window_days`, number): Click window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- Engagement window days (`engagement_window_days`, number): Engagement window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `30`.
- View window days (`view_window_days`, number): View window days. One of: `0`, `1`, `7`, `14`, `30`, `60`. Default: `1`.
- Conversion report time (`conversion_report_time`, text): Conversion report time. One of: `TIME_OF_AD_ACTION` (Time of ad action), `TIME_OF_CONVERSION` (Time of conversion). Default: `TIME_OF_AD_ACTION`.
- Attribution types (`attribution_types`, list): Attribution types. One or more of: `INDIVIDUAL`, `HOUSEHOLD`.
- Reporting timezone (`reporting_timezone`, text): Specify the timezone to be applied for the reporting. One of: `PINTEREST_TIME_ZONE` (Pinterest time zone), `AD_ACCOUNT_TIME_ZONE` (Ad account time zone).

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "data": []
  }
}
```

### List ad accounts

List the ad accounts you have access to, optionally including ones shared with you.

**Inputs**

- Include shared accounts (`include_shared_accounts`, true/false): Include shared accounts. Default: `true`.
- Bookmark (`bookmark`, text): Bookmark.
- Page size (`page_size`, number): Page size. From 1 to 250. Default: `25`.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "bookmark": "example",
    "items": []
  }
}
```

### List ad groups

List ad groups in an ad account, optionally only for some campaigns or ad groups.

**Inputs**

- Bookmark (`bookmark`, text): Bookmark.
- Page size (`page_size`, number): Page size. From 1 to 250. Default: `25`.
- Order (`order`, text): Order. One of: `ASCENDING`, `DESCENDING`. Default: `ASCENDING`.
- Ad account (`ad_account_id`, text, required): Ad account id.
- Campaign ids (`campaign_ids`, list): Campaign ids.
- Ad group ids (`ad_group_ids`, list): Ad group ids.
- Entity statuses (`entity_statuses`, list): Entity statuses. One or more of: `ACTIVE`, `PAUSED`, `ARCHIVED`, `DRAFT`, `DELETED_DRAFT` (Deleted draft). Default: `["ACTIVE", "PAUSED"]`.
- Translate interests to names (`translate_interests_to_names`, true/false): Translate interests to names. Default: `false`.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "bookmark": "example",
    "items": []
  }
}
```

### List ads

List ads in an ad account, optionally only for some campaigns, ad groups or ads.

**Inputs**

- Bookmark (`bookmark`, text): Bookmark.
- Page size (`page_size`, number): Page size. From 1 to 250. Default: `25`.
- Order (`order`, text): Order. One of: `ASCENDING`, `DESCENDING`. Default: `ASCENDING`.
- Ad account (`ad_account_id`, text, required): Ad account id.
- Campaign ids (`campaign_ids`, list): Campaign ids.
- Ad group ids (`ad_group_ids`, list): Ad group ids.
- Ad ids (`ad_ids`, list): Ad ids.
- Entity statuses (`entity_statuses`, list): Entity statuses. One or more of: `ACTIVE`, `PAUSED`, `ARCHIVED`, `DRAFT`, `DELETED_DRAFT` (Deleted draft). Default: `["ACTIVE", "PAUSED"]`.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "bookmark": "example",
    "items": []
  }
}
```

### List campaigns

List the campaigns in an ad account, with optional filters.

**Inputs**

- Bookmark (`bookmark`, text): Bookmark.
- Page size (`page_size`, number): Page size. From 1 to 250. Default: `25`.
- Order (`order`, text): Order. One of: `ASCENDING`, `DESCENDING`. Default: `ASCENDING`.
- Ad account (`ad_account_id`, text, required): Ad account id.
- Campaign ids (`campaign_ids`, list): Campaign ids.
- Entity statuses (`entity_statuses`, list): Entity statuses. One or more of: `ACTIVE`, `PAUSED`, `ARCHIVED`, `DRAFT`, `DELETED_DRAFT` (Deleted draft). Default: `["ACTIVE", "PAUSED"]`.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "bookmark": "example",
    "items": []
  }
}
```

### List conversion tags

List an ad account's conversion tags.

**Inputs**

- Filter deleted (`filter_deleted`, true/false): Filter deleted. Default: `false`.
- Ad account (`ad_account_id`, text, required): Ad account id.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "items": []
  }
}
```

### Update ad groups

Update one or more ad groups.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Request body (`request_body`, list, required): Request body.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "items": []
  }
}
```

### Update ads

Update one or more ads.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Request body (`request_body`, list, required): Request body.

**Outputs**

- `data` (object): Pinterest Ads response data.

**Example output**

```json
{
  "data": {
    "items": []
  }
}
```

### Update campaigns

Update one or more campaigns.

**Inputs**

- Ad account (`ad_account_id`, text, required): Ad account id.
- Request body (`request_body`, list, required): Request body for batch campaign update.

**Outputs**

- `data` (object): Response model for batch campaign write operations.

**Example output**

```json
{
  "data": {
    "items": []
  }
}
```
