Pinterest Ads API for managing advertising accounts, campaigns, ad groups, ads, targeting, and reporting.
Description is untrusted, display-only upstream metadata. It never becomes policy, OAuth scope authority, or an agent instruction.
Pakkawork boundary
Research catalogue metadata only. No Pakkawork OAuth, credential, host, quota, executor, or verifier is enabled.
No Pakkawork execution adapter is enabled. Hosted account-authorisation availability is workspace-specific and checked separately in the dashboard.Check workspace connection options
Only field names, types, and required markers are shown. Secret values, default auth URLs, credential material, and inferred OAuth scopes are excluded.
OAUTH2 · managed upstream
OAUTH2
pinterest_ads_oauth
Upstream managed
Developer setup
Client idclient_id · stringRequired
Client secretclient_secret · stringRequired
Redirect URIoauth_redirect_uri · stringOptional
Scopesscopes · stringOptional
User connection
No fields declared in this snapshot.
Capability index
Actions and trigger definitions
Static summaries are available. Live schemas remain disabled until PROVIDER_HUB_API_KEY is configured server-side.
Get synchronous Pinterest Ads performance metrics for an advertiser or selected campaigns, ad groups, or ads over a date range.
Untrusted display-only summary
Get Metrics Ready State
PINTEREST_ADS_GET_METRICS_READY_STATE
Check whether Pinterest conversion and non-conversion metrics are finalized for a UTC report date before relying on analytics results.
Untrusted display-only summary
Get Targeting Options
PINTEREST_ADS_GET_TARGETING_OPTIONS
Get Pinterest's valid targeting values for a targeting type, such as age buckets, gender, locale, location, interests, or keywords.
Untrusted display-only summary
List Ad Accounts
PINTEREST_ADS_LIST_AD_ACCOUNTS
List advertiser accounts the connected Pinterest user owns or can access, including the IDs needed by all other Ads tools.
Untrusted display-only summary
List Ad Groups
PINTEREST_ADS_LIST_AD_GROUPS
List ad groups for an advertiser, filter by parent campaigns, or look up specific ad groups by ID.
Untrusted display-only summary
List Ads
PINTEREST_ADS_LIST_ADS
List 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.
Untrusted display-only summary
List Campaigns
PINTEREST_ADS_LIST_CAMPAIGNS
List 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.
Untrusted display-only summary
Update Ad Groups
PINTEREST_ADS_UPDATE_AD_GROUPS
Rename, 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.
Untrusted display-only summary
Update Ads
PINTEREST_ADS_UPDATE_ADS
Rename, 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.
Untrusted display-only summary
Update Campaigns
PINTEREST_ADS_UPDATE_CAMPAIGNS
Rename, 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.
Untrusted display-only summary
Provenance
Versioned facts, explicit trust.
The detail snapshot comes from an attributed MIT-licensed repository revision. Safe local icons use exact-match CC0 Simple Icons symbols; unmatched brands use monograms.