Pinterest Ads for AI agents
Agents read Pinterest Ads at once. Changes and sends are held for a person's approval by default.
About Pinterest Ads
Pinterest Ads API for managing advertising accounts, campaigns, ad groups, ads, targeting, and reporting.
What an agent can do in Pinterest Ads
Every Pinterest Ads action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Pinterest Ads without asking first. 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. Archived and draft ads must be requested explicitly with entity_statuses.
- List CampaignsList campaigns for an advertiser, or look up specific campaigns by ID using campaign_ids. Archived and draft campaigns must be requested explicitly with entity_statuses.
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 3 actions.
- 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 cha
- 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 cha
- 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 wait in Needs you
Changes and sends in Pinterest Ads are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Pinterest Ads questions
Can an agent change data in Pinterest Ads on its own?
Not by default. Changes and sends in Pinterest Ads are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Pinterest Ads?
This connector lists 7 read actions. Reads run at once, without waiting for approval.
How does Pinterest Ads connect?
It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.