Skip to content
Get MCP AdsGet MCP Ads, home

pinterest_validate_report

Validate and preview how a Pinterest report will execute. One of 56 Pinterest Ads tools on the Get MCP Ads MCP gateway.

Validate and preview how a Pinterest report will execute. Returns sync/async routing, endpoint, level, columns, attribution settings, and warnings without calling performance endpoints.

Kind
Read
Discovery
Reachable through search_tools and run_tool
Account parameter
adAccountId
Endpoint
https://mcp.getmcpads.com/pinterest-ads/mcp

ParametersLink to this section

NameTypeRequiredNotes
adAccountIdstringOptionalOwning advertising account ID. Use the exact ID returned by account discovery; do not substitute a campaign or business ID.
levelstringOptionalEntity or aggregation level for the requested report. One of: AD_ACCOUNT, CAMPAIGN, AD_GROUP, AD, PRODUCT_GROUP. Default: "CAMPAIGN".
startDatestringRequiredFirst date of the reporting period, in YYYY-MM-DD format.
endDatestringRequiredLast date of the reporting period, in YYYY-MM-DD format, on or after startDate.
granularitystringOptionalTime bucket used to aggregate reporting rows. One of: TOTAL, DAY, WEEK, MONTH, HOUR. Default: "DAY".
columnsarrayOptionalNative Pinterest reporting column names. Discover supported columns before selecting metrics. Default: ["SPEND_IN_DOLLAR","IMPRESSION_1","CLICKTHROUGH_1","OUTBOUND_CLICK_1","REPIN_1","TOTAL_CHECKOUT","TOTAL_CHECKOUT_VALUE_IN_MICRO_DOLLAR","CHECKOUT_ROAS"].
executionModestringOptionalChoose the supported synchronous, asynchronous or automatic report execution strategy. One of: auto, sync, async. Default: "auto".
entityIdsarrayOptionalExact IDs of the entities to include in the selected reporting level.
targetingTypesarrayOptionalNative targeting categories used to break down delivery.
clickWindowDaysintegerOptionalClick-through attribution window, in days. Default: 30.
engagementWindowDaysintegerOptionalEngagement-through attribution window, in days. Default: 30.
viewWindowDaysintegerOptionalView-through attribution window, in days. Default: 1.
conversionReportTimestringOptionalWhether conversions are assigned to the ad action date or the conversion date. One of: TIME_OF_AD_ACTION, TIME_OF_CONVERSION. Default: "TIME_OF_AD_ACTION".
attributionTypesarrayOptionalProvider attribution categories included in the report.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "pinterest_validate_report",
    "args": {
      "startDate": "<string>",
      "endDate": "<string>"
    }
  }
}
Esc

Type to search