Pinterest Ads
for LuumenAI

Pinterest Ads API for managing advertising accounts, campaigns, ad groups, ads, targeting, and reporting.

Bring Pinterest Ads into the same conversation as the systems behind it. LuumenAI reads campaigns, audiences, and delivery status for context, and changes them only through previewed, approved, audited actions.

The Pinterest Ads toolbox

10 tools: 7 read, 3 write. Reads answer instantly. Writes require approval by default. Everything is logged.

  • ReadGet Ads AnalyticsGet synchronous Pinterest Ads performance metrics for an advertiser or selected campaigns, ad groups, or ads over a date range.
  • ReadGet Metrics Ready StateCheck whether Pinterest conversion and non-conversion metrics are finalized for a UTC report date before relying on analytics results.
  • ReadGet Targeting OptionsGet Pinterest's valid targeting values for a targeting type, such as age buckets, gender, locale, location, interests, or keywords.
  • ReadList Ad AccountsList advertiser accounts the connected Pinterest user owns or can access, including the IDs needed by all other Ads tools.
  • ReadList Ad GroupsList ad groups for an advertiser, filter by parent campaigns, or look up specific ad groups by ID.
  • ReadList AdsList ads for an advertiser, filter by one hierarchy level, or look up specific ads by ID.
  • ReadList CampaignsList campaigns for an advertiser, or look up specific campaigns by ID using campaign_ids.
  • WriteUpdate Ad GroupsRename, pause, or resume up to 30 existing ad groups. Approval by default
  • WriteUpdate AdsRename, pause, or resume up to 30 existing Pinterest ads. Approval by default
  • WriteUpdate CampaignsRename, pause, or resume up to 30 existing campaigns. Approval by default

Questions

How does LuumenAI connect to Pinterest Ads?

Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

Can LuumenAI change things in Pinterest Ads on its own?

Read actions answer immediately. Anything that writes — update ad groups, update ads, update campaigns — is shown as a plan and requires approval by default, including the 3 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.

Who gets access to the integration?

You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.

Is there an audit trail?

Every call to Pinterest Ads — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.

Put Pinterest Ads to work with Luumen

Connect in minutes. Every action scoped, approved, and audited from day one.