All integrations
Catalogue metadata onlyads & conversionv20260826_00

PINTEREST_ADS

Pinterest Ads

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
Attributed source

10

Action summaries

Display-only definitions

0

Trigger types

Not installed instances

1

Auth modes

Field names, never values

No

Execution

No runtime adapter

Authentication map

What setup is declared?

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.

Showing 1–10 of 10 actions

Get Ads Analytics

PINTEREST_ADS_GET_ANALYTICS

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.

Repository
https://github.com/provider-directoryHQ/provider-directory
Commit
85e33f6a81dfe987f6fc3637d48d45052cea8ca5
Generated
2026-09-12
Trust policy
untrusted_display_only

Remote text is plain display metadata only. It must never become an agent prompt, execution policy, OAuth grant, or executable instruction.