- Category: ads & conversion
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 10
- Triggers: 0
- Slug:
PINTEREST_ADS - Version: 20261030_00
Tools
Get Ads Analytics
Get Ads Analytics
Slug:
PINTEREST_ADS_GET_ANALYTICSGet synchronous Pinterest Ads performance metrics for an advertiser or selected campaigns, ad groups, or ads over a date range.Input Parameters
Supported Pinterest metrics and identifiers to return. MICRO_DOLLAR values are advertiser-currency microunits.
Campaign, ad-group, or ad IDs for the chosen entity_level. Required unless entity_level is AD_ACCOUNT; forbidden for AD_ACCOUNT.
UTC report start date. It may be at most 90 days before today, or 8 days before today when granularity is HOUR.
Time grouping for metric rows: TOTAL, DAY, HOUR, WEEK, or MONTH. HOUR no longer provides conversion metrics, is limited to the previous 8 days, and has a 3-day maximum range for campaign, ad-group, and ad reports.
Reporting level. Entity IDs are required for CAMPAIGN, AD_GROUP, and AD, and forbidden for AD_ACCOUNT.
Attribute conversion rows to the ad interaction date or conversion date.
Output
Get Metrics Ready State
Get Metrics Ready State
Get Targeting Options
Get Targeting Options
Slug:
PINTEREST_ADS_GET_TARGETING_OPTIONSGet Pinterest’s valid targeting values for a targeting type, such as age buckets, gender, locale, location, interests, or keywords.Input Parameters
Optional advertiser account context. Omit to retrieve options for the connected Pinterest user.
string ("APPTYPE" | "GENDER" | "LOCALE" | "AGE_BUCKET" | "LOCATION" | "GEO" | "INTEREST" | "KEYWORD" | "AUDIENCE_INCLUDE" | "AUDIENCE_EXCLUDE")
required
Pinterest targeting dimension whose valid values to retrieve.
Output
List Ad Accounts
List Ad Accounts
List Ad Groups
List Ad Groups
List Ads
List Ads
Slug:
PINTEREST_ADS_LIST_ADSList ads for an advertiser, filter by one hierarchy level, or look up specific ads by ID. Archived and draft ads must be requested explicitly with entity_statuses.Input Parameters
Sort by ad ID. Higher IDs are associated with more recently added ads.
Optional ad IDs to look up. Cannot be combined with campaign_ids or ad_group_ids; omit all ID filters to list ads.
Optional parent ad-group IDs used to filter ads. This beta filter may not be available to every advertiser and cannot be combined with campaign_ids or ad_ids.
Optional parent campaign IDs used to filter ads. Cannot be combined with ad_group_ids or ad_ids.
Output
List Campaigns
List Campaigns
Update Ad Groups
Update Ad Groups
Slug:
PINTEREST_ADS_UPDATE_AD_GROUPSRename, pause, or resume up to 30 existing ad groups. Setting status to ACTIVE can restart delivery and incur spend under existing budgets. Budget, bid, targeting, schedule, and restricted-setting changes are not exposed.Input Parameters
One to 30 ad-group changes. IDs must be unique; each item must set a new name, ACTIVE status, or PAUSED status.
Output
Update Ads
Update Ads
Slug:
PINTEREST_ADS_UPDATE_ADSRename, pause, or resume up to 30 existing Pinterest ads. Setting status to ACTIVE can restart delivery and incur spend under existing budgets. Creative, Pin, destination, tracking, and disclosure changes are not exposed.Input Parameters
One to 30 ad updates. IDs must be unique, and each item must set a name, an ACTIVE status, or a PAUSED status.
Output
Update Campaigns
Update Campaigns
Slug:
PINTEREST_ADS_UPDATE_CAMPAIGNSRename, pause, or resume up to 30 existing campaigns. Setting status to ACTIVE can restart delivery and incur spend under existing budgets. Budget, schedule, objective, archive, and restricted-setting changes are not exposed.Input Parameters
Campaign changes (1-30). Each item requires a unique campaign ID and at least one of non-empty name or ACTIVE/PAUSED status.