Pinterest Ads tools in Cogny
Cogny's Pinterest Ads integration exposes 16 tools (10 read, 6 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.
New connections open once Pinterest approves Cogny's app for Ads API access.
- Read (10): only reads data.
- Write (6): creates or changes something.
- Destructive (0): deletes, removes or replaces something.
Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits.
Connecting and limits
Connecting asks for five Pinterest permissions: read and edit advertising data, read boards, read Pins, and read your account details. Cogny does not ask to create, edit or delete Pins or boards.
The tools reach the ad accounts your Pinterest login has a role on. After connecting you pick which of them the workspace may use; the others are refused.
New campaigns, ad groups and ads are created paused. Nothing starts spending until someone activates it.
Analytics cover at most 90 days per request and go back up to 914 days.
Known gaps
- No tool creates a Pin. A Pinterest ad promotes an existing Pin, so the Pin is made on Pinterest first;
tool_list_board_pinsthen finds it andtool_create_adpromotes it. - No tools for keywords, negative keywords, catalogs or product groups yet. Shopping campaigns can be read and paused, not built.
- No tool creates or edits audiences.
tool_list_audiencesreads the ones made in Ads Manager, and their ids work in ad group targeting.
All tools
| Tool | Kind | What it does |
|---|---|---|
tool_list_ad_accounts | Read | List the Pinterest ad accounts the connection can reach, with currency and country. |
tool_get_campaigns | Read | List campaigns in a Pinterest ad account with objective, status and spend caps. |
tool_get_ad_groups | Read | List ad groups with their targeting, budget, bid and schedule. |
tool_get_ads | Read | List ads with the Pin each one promotes, creative type, status and review state. |
tool_get_analytics | Read | Get spend, impressions, clicks, saves and conversions for an account, campaigns, ad groups or ads. |
tool_list_audiences | Read | List the audiences in an ad account (customer lists, visitors, engagement, actalikes) with size and status. |
tool_list_conversion_tags | Read | List the Pinterest tags (conversion tracking) installed for an ad account and their status. |
tool_get_targeting_options | Read | Look up the values Pinterest accepts for a targeting dimension (interests, locations, locales, ages, genders, app types). |
tool_list_boards | Read | List the connected Pinterest account's boards, to find Pins to promote. |
tool_list_board_pins | Read | List the Pins on a board with title, link and image, to pick one to promote. |
tool_create_campaign | Write | Create a Pinterest campaign (created PAUSED). |
tool_update_campaign | Write | Change a campaign's status (ACTIVE, PAUSED, ARCHIVED), name, spend caps or end time. |
tool_create_ad_group | Write | Create an ad group with targeting, budget and bidding inside a campaign (created PAUSED). |
tool_update_ad_group | Write | Change an ad group's status, budget, bid, targeting or end time. |
tool_create_ad | Write | Promote an existing Pin as an ad inside an ad group (created PAUSED, then reviewed by Pinterest). |
tool_update_ad_status | Write | Activate, pause or archive an ad. |
Exact input schemas come from tools/list once Pinterest Ads is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.