# Pinterest Ads

```json
{
  "name": "Pinterest Ads",
  "slug": "pinterest_ads",
  "url": "https://composio.dev/toolkits/pinterest_ads",
  "markdown_url": "https://composio.dev/toolkits/pinterest_ads.md",
  "logo_url": "https://logos.composio.dev/api/pinterest_ads",
  "categories": [
    "advertising & marketing"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-08-10T12:34:40.948Z"
}
```

![Pinterest Ads logo](https://logos.composio.dev/api/pinterest_ads)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Pinterest Ads MCP or direct API to manage ad accounts, create campaigns, optimize ad groups, and pull performance reports through natural language.

## Summary

Pinterest Ads is Pinterest's advertising platform for campaigns, ad groups, ads, targeting, and reporting.
Use it to reach high-intent shoppers and track performance across the Pinterest funnel.

## Categories

- advertising & marketing

## Toolkit Details

- Tools: 10

## Images

- Logo: https://logos.composio.dev/api/pinterest_ads

## Authentication

- **Oauth2**
  - Type: `oauth2`
  - Description: Oauth2 authentication for Pinterest Ads.
  - Setup:
    - Configure Oauth2 credentials for Pinterest Ads.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Review yesterday's Pinterest campaign performance
- Pause underperforming ad groups today
- List active Pinterest ad campaigns

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `PINTEREST_ADS_GET_ANALYTICS` | Get Ads Analytics | Get synchronous Pinterest Ads performance metrics for an advertiser or selected campaigns, ad groups, or ads over a date range. |
| `PINTEREST_ADS_GET_METRICS_READY_STATE` | Get Metrics Ready State | Check whether Pinterest conversion and non-conversion metrics are finalized for a UTC report date before relying on analytics results. |
| `PINTEREST_ADS_GET_TARGETING_OPTIONS` | Get Targeting Options | Get Pinterest's valid targeting values for a targeting type, such as age buckets, gender, locale, location, interests, or keywords. |
| `PINTEREST_ADS_LIST_AD_ACCOUNTS` | List Ad Accounts | List advertiser accounts the connected Pinterest user owns or can access, including the IDs needed by all other Ads tools. |
| `PINTEREST_ADS_LIST_AD_GROUPS` | List Ad Groups | List ad groups for an advertiser, filter by parent campaigns, or look up specific ad groups by ID. |
| `PINTEREST_ADS_LIST_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. |
| `PINTEREST_ADS_LIST_CAMPAIGNS` | 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. |
| `PINTEREST_ADS_UPDATE_AD_GROUPS` | 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. |
| `PINTEREST_ADS_UPDATE_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. |
| `PINTEREST_ADS_UPDATE_CAMPAIGNS` | 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. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Pinterest Ads Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Pinterest Ads actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'List active Pinterest Ads campaigns and summarize yesterday\'s spend and clicks.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List active Pinterest Ads campaigns and summarize yesterday\'s spend and clicks.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Pinterest Ads
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Pinterest Ads tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Get yesterday\'s performance report for my active Pinterest Ads campaigns.')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Get yesterday\'s performance report for my active Pinterest Ads campaigns.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Pinterest Ads Integration

- Supports both Pinterest Ads MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable campaign, ad group, ad, targeting, and reporting actions
- Rich coverage for reading, writing, and querying your Pinterest Ads data without custom API glue

### 2. Managed Auth

- Built-in OAuth handling with secure token storage, refresh, and lifecycle management
- Central place to manage, scope, and revoke Pinterest Ads access
- Per user and per environment credentials instead of hard-coded keys in your agent code

### 3. Agent Optimized Design

- Tools are tuned for AI agents, so campaign and reporting workflows are easier for models to call correctly
- Comprehensive execution logs so you can see which Pinterest Ads actions ran, when, and on whose behalf
- Cleaner tool schemas help agents ask for the right ad account, campaign, date range, and metrics

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Pinterest Ads
- Scoped, least privilege access to Pinterest Ads resources such as campaigns, ads, and reports
- Full audit trail of agent actions to support review, debugging, and compliance

## Use Pinterest Ads with any AI Agent Framework

Choose a framework you want to connect Pinterest Ads with:

- [ChatGPT Work](https://composio.dev/toolkits/pinterest_ads/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/pinterest_ads/framework/claude-cowork)

## Related Toolkits

- [Metaads](https://composio.dev/toolkits/metaads) - Metaads is Meta's official Ads API that lets you manage, analyze, and optimize your Facebook and Instagram ad campaigns. Streamline ad operations and gain deeper insights with robust automation.
- [Adrapid](https://composio.dev/toolkits/adrapid) - Adrapid is a platform for rapid creation of digital marketing visuals using templates. It streamlines design workflows for banners, images, and HTML5 content with automation.
- [Adyntel](https://composio.dev/toolkits/adyntel) - Adyntel is an API that retrieves LinkedIn ads for any company using a domain or LinkedIn Page ID. Easily access competitive ad intelligence to power your marketing workflows.
- [Beaconstac](https://composio.dev/toolkits/beaconstac) - Beaconstac is a platform for creating and managing QR codes and proximity beacons. It helps businesses engage customers and track marketing performance with powerful analytics.
- [Bouncify](https://composio.dev/toolkits/bouncify) - Bouncify is an email verification service for single addresses and bulk lists. Use it to reduce bounces, protect sender reputation, and track verification credits.
- [Campaign cleaner](https://composio.dev/toolkits/campaign_cleaner) - Campaign cleaner is an email campaign optimization tool that boosts compatibility and deliverability across email clients. It helps marketers get better results by cleaning, enhancing, and ensuring high performance for every campaign.
- [Deadline funnel](https://composio.dev/toolkits/deadline_funnel) - Deadline Funnel lets you create personalized deadlines and timers for your marketing campaigns. It helps marketers boost conversions by adding authentic urgency to offers.
- [GoDaddy MCP](https://composio.dev/toolkits/godaddy_mcp) - GoDaddy MCP is a domain discovery toolkit for checking availability and generating AI-powered name ideas. Use it to move from rough business keywords to practical domain options fast.
- [Google Ads](https://composio.dev/toolkits/googleads) - Google Ads is Google's online advertising platform for creating, managing, and optimizing digital campaigns. It helps businesses reach targeted customers and maximize return on ad spend.
- [Instantly](https://composio.dev/toolkits/instantly) - Instantly is a platform for automating cold email outreach, managing leads, and optimizing deliverability. Get better results from email campaigns with minimal manual effort.
- [Keyword](https://composio.dev/toolkits/keyword) - Keyword.com is a digital marketing platform for search rank tracking and SEO analytics. Use it to monitor keyword performance, spot ranking changes, and measure SEO visibility.
- [Linkedin Ads](https://composio.dev/toolkits/linkedin_ads) - Linkedin Ads is LinkedIn's marketing platform for creating, managing, and measuring paid campaigns across LinkedIn. It helps teams reach professional audiences with precise targeting, campaign analytics, and sponsored content tools.
- [Proofly](https://composio.dev/toolkits/proofly) - Proofly is a social proof platform that displays real-time notifications of customer activity on your site. It helps you increase website conversions by building trust and urgency for visitors.
- [Reddit Ads](https://composio.dev/toolkits/reddit_ads) - Reddit Ads is Reddit's advertising platform for running paid campaigns, managing ad accounts, and tracking conversions. It helps advertisers reach high-intent communities with targeted, interest-based campaigns.
- [Segmetrics](https://composio.dev/toolkits/segmetrics) - Segmetrics is a marketing analytics platform that reveals detailed insights into your customer journeys. It helps businesses optimize marketing strategies with accurate, actionable reporting.
- [Semrush](https://composio.dev/toolkits/semrush) - Semrush is a leading SEO tool suite for keyword research, competitor analysis, and campaign tracking. It empowers marketers to improve search rankings and optimize online visibility.
- [Sendloop](https://composio.dev/toolkits/sendloop) - Sendloop is an all-in-one email marketing platform built for SaaS, e-commerce, and small businesses. It makes it easy to send campaigns, manage lists, and track results—all in one place.
- [Sidetracker](https://composio.dev/toolkits/sidetracker) - Sidetracker is a marketing analytics platform that tracks expenses, sales funnels, and customer journeys. It helps optimize marketing spend and visualize campaign performance from start to finish.
- [Snapchat](https://composio.dev/toolkits/snapchat) - Snapchat is a multimedia messaging and social platform with camera-first content, Stories, and Ads Manager. It helps brands reach mobile audiences with visual ads and measurable campaign performance.
- [Stannp](https://composio.dev/toolkits/stannp) - Stannp is an API-driven direct mail platform for sending postcards and letters programmatically. It lets you automate physical mail delivery—no manual printing or mailing required.

## Frequently Asked Questions

### Do I need my own developer credentials to use Pinterest Ads with Composio?

Yes, Pinterest Ads requires you to configure your own OAuth credentials. Once set up, Composio handles token storage, refresh, and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)