View all systems 
Pinterest Adsads & conversion
10 available actions
What your AI agent can do in Pinterest Ads
Pinterest Ads API for managing advertising accounts, campaigns, ad groups, ads, targeting, and reporting. This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.
Showing all 10 actions.
Common starting points
- Get Ads AnalyticsGet synchronous Pinterest Ads performance metrics for an advertiser or selected campaigns, ad groups, or ads over a date range.
- Get Metrics Ready StateCheck whether Pinterest conversion and non-conversion metrics are finalized for a UTC report date before relying on analytics results.
- Update Ad GroupsRename, pause, or resume up to 30 existing ad groups.
- Update AdsRename, pause, or resume up to 30 existing Pinterest ads.
Browse all 10 actions by capability
Open a capability to see every supported action and its description.
Find & reviewLook up and review existing recordsView 7 actions
- Get Ads AnalyticsGet synchronous Pinterest Ads performance metrics for an advertiser or selected campaigns, ad groups, or ads over a date range.
- Get Metrics Ready StateCheck whether Pinterest conversion and non-conversion metrics are finalized for a UTC report date before relying on analytics results.
- Get Targeting OptionsGet Pinterest's valid targeting values for a targeting type, such as age buckets, gender, locale, location, interests, or keywords.
- List Ad AccountsList advertiser accounts the connected Pinterest user owns or can access, including the IDs needed by all other Ads tools.
- List Ad GroupsList ad groups for an advertiser, filter by parent campaigns, or look up specific ad groups by ID.
- List AdsList ads for an advertiser, filter by one hierarchy level, or look up specific ads by ID.
- List CampaignsList campaigns for an advertiser, or look up specific campaigns by ID using campaign_ids.
Update & manageChange and manage existing recordsView 3 actions
- Update Ad GroupsRename, pause, or resume up to 30 existing ad groups.
- Update AdsRename, pause, or resume up to 30 existing Pinterest ads.
- Update CampaignsRename, pause, or resume up to 30 existing campaigns.
Connection record
A connection you can control.
- Sign-in
- OAuth sign-in
- Setup
- Sign in with your own Pinterest Ads account. Access is limited to the work agreed for the role.
- Boundaries
- Only the approved role and actions.
- Off switch
- Revoke the connection from your account.
FAQ
Before you connect Pinterest Ads
How does the agent connect to Pinterest Ads?
You sign in with your own Pinterest Ads account. Permissions are limited to what the agent needs, the connection is health-checked, and you can revoke access from Pinterest Ads at any time.
What can the agent actually do in Pinterest Ads?
The page above lists the 10 actions currently available through the Pinterest Ads connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.
Is Pinterest Ads included in my plan?
Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.
How long until Pinterest Ads is ready?
Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.
Bring the workflow together
Ready to put Pinterest Ads to work?
Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.