Pinterest connector for AI agents

Tools your social media agent reaches for on Pinterest, scoped per user.

CALL ANY TOOL

72 tools for social media on Pinterest: create and update Pins and boards, read analytics, manage catalogs, feeds, and product groups, and research trends.

pinterest_board_create

Create board

Create a new board on the authenticated Pinterest account, or on a Business Access ad account you manage. Returns the created board's full details: id, name, description, privacy setting, and creation metadata. Use this to make a new board before adding Pins or sections to it. Use pinterest_board_update to change an existing board instead.

Parameters

Name

Type

Required

Description

name

string

Required

Name of the board to create. Example: Summer recipes.

ad_account_id

string

Optional

Unique identifier of a Business Access ad account to use as the operating account for this creation, instead of the token user's own account. Only needed when using Pinterest Business Access to create a board owned by that ad account's user; the token user must hold an appropriate Business Access role on the ad account. Numeric string, up to 18 digits. Example: 549755885175.

description

string

Optional

Description of the board's purpose or content. Plain text, shown to board visitors. Example: My favorite summer recipes.

is_ads_only

boolean

Optional

If true, the board is created as ad-only and can store ad-only Pins. When set, the board's name automatically becomes "Ad-only Pins" and its privacy is forced to PROTECTED, overriding the name and privacy fields. Defaults to false. Default: `false`.

privacy

string

Optional

Privacy setting for the board. PUBLIC boards are visible to everyone; PROTECTED boards are visible only to people you approve; SECRET boards are visible only to you and collaborators. Defaults to PUBLIC. One of: `PUBLIC`, `PROTECTED`, `SECRET`. Default: `PUBLIC`.

pinterest_board_get

Get board

pinterest_board_pins_list

List board pins

pinterest_board_section_update

Update board section

pinterest_board_sections_list

List board sections

pinterest_boards_search

Search boards

pinterest_catalog_create

Create catalog

pinterest_catalog_feed_ingest

Catalog feed ingest

pinterest_catalog_feeds_list

List catalog feeds

pinterest_catalog_item_issues_list

List catalog item issues

pinterest_catalog_items_batch_create

Create catalog items batch

pinterest_catalog_items_batch_get

Get catalog items batch

pinterest_catalog_local_stores_create

Create catalog local stores

pinterest_catalog_local_stores_list

List catalog local stores

pinterest_catalog_local_stores_update

Update catalog local stores

pinterest_catalog_product_group_product_counts_get

Get catalog product group product counts

pinterest_catalog_products_by_filter_list

List catalog products by filter

Preview which catalog products would match a given product-group filter, without creating a product group. Supports a feed-based filter (feed_id + filters) or a catalog/vertical-based filter for RETAIL, HOTEL, or CREATIVE_ASSETS catalogs (catalog_id + catalog_type + filters). Returns a page of matching catalog products plus a bookmark cursor for the next page. Use this to test and refine a filters object before calling pinterest_catalog_product_group_create or pinterest_catalog_product_group_update.

Parameters

Name

Type

Required

Description

filters

object

Required

Object holding the filter criteria to preview matches for. Shape: {"any_of": [<filter key objects>]} to match items satisfying ANY listed criterion, or {"all_of": [<filter key objects>]} to require ALL of them. Each filter key object has one key (e.g. ITEM_ID, MIN_PRICE, BRAND, AVAILABILITY, CUSTOM_LABEL_0) whose value is a criteria object, typically {"values": [...]} and optionally {"negated": true}. Cannot be empty. Example: {"any_of": [{"ITEM_ID": {"values": ["123456789"]}}]}.

ad_account_id

string

Optional

Unique identifier of a Business Access ad account to use as the operating account for this preview, instead of the token user's own account. Only needed when using Pinterest Business Access; the token user must hold an appropriate Business Access role on the ad account. Numeric string, up to 18 digits. Example: 549755885175.

bookmark

string

Optional

Pagination cursor returned as 'bookmark' in a previous response. Pass it to fetch the next page of results. Omit for the first page.

catalog_id

string

Optional

Catalog ID to preview matches against. Required, together with catalog_type, when previewing a catalog/vertical-based filter instead of a feed-based one. Numeric string. Example: 2680059592705.

catalog_type

string

Optional

Selects a catalog/vertical-based filter preview instead of a feed-based one. When set, catalog_id is required and feed_id must be omitted. RETAIL additionally requires country and locale. Valid values: RETAIL, HOTEL, CREATIVE_ASSETS. Omit entirely to preview a feed-based filter with feed_id instead. One of: `RETAIL`, `HOTEL`, `CREATIVE_ASSETS`.

country

string

Optional

ISO 3166-1 alpha-2 country code to preview matches against. Required, together with locale, when catalog_type is RETAIL; not used for HOTEL, CREATIVE_ASSETS, or feed-based filters. Two-letter code. Example: US.

feed_id

string

Optional

Catalog Feed ID to preview matches against. Required when previewing a feed-based filter, i.e. when catalog_type is omitted. Must be omitted when catalog_type is set. Numeric string. Example: 2680059592705.

locale

string

Optional

Locale to preview matches against. Required, together with country, when catalog_type is RETAIL; not used for HOTEL, CREATIVE_ASSETS, or feed-based filters. Format: language-COUNTRY or language. Example: en-US.

page_size

integer

Optional

Maximum number of products to return in a single page. Between 1 and 250. Defaults to 25. Default: `25`.

pin_metrics

boolean

Optional

Whether to include 90-day and lifetime Pin engagement metrics in the response for each returned product's Pin. Defaults to false. Default: `false`.

pinterest_catalog_report_create

Create catalog report

pinterest_catalogs_list

List catalogs

pinterest_media_get

Get media

pinterest_pin_get

Get pin

pinterest_pin_product_tags_add

Add pin product tags

pinterest_pin_product_tags_delete

Delete pin product tags

pinterest_pins_analytics_list

List pins analytics

pinterest_terms_related_list

List terms related

pinterest_trends_keywords_list

List trends keywords

List the top trending search keywords among the Pinterest user audience for a region and trend type. Returns an ordered array of trending keywords, each with the keyword text, week-over-week / month-over-month / year-over-year percent growth, a normalized search-volume time series, and optional age/gender demographics. Use this to inform ad targeting, budget strategy, and creative decisions. Use the trend product categories or featured topics tools instead for shopping-category or interest-level trend data rather than raw keywords.

Parameters

Name

Type

Required

Description

region

string

Required

The geographic region of interest. Only top trends within this region are returned. Formatted as ISO 3166-2 country codes, with multi-country regions delimited by '+'. Valid values: US, CA, DE, FR, ES, IT, DE+AT+CH (Germanic countries), GB+IE (Great Britain & Ireland), IT+ES+PT+GR+MT (Southern Europe), PL+RO+HU+SK+CZ (Eastern Europe), SE+DK+FI+NO (Nordic countries), NL+BE+LU (Benelux), AR, BR, CO, MX, MX+AR+CO+CL (Hispanic LatAm), AU+NZ (Australasia). Example: GB+IE. One of: `US`, `CA`, `DE`, `FR`, `ES`, `IT`, `DE+AT+CH`, `GB+IE`, `IT+ES+PT+GR+MT`, `PL+RO+HU+SK+CZ`, `SE+DK+FI+NO`, `NL+BE+LU`, `AR`, `BR`, `CO`, `MX`, `MX+AR+CO+CL`, `AU+NZ`.

trend_type

string

Required

The methodology used to rank how trendy a keyword is. `growing` trends have high upward growth in search volume over the last quarter. `monthly` trends have high search volume in the last month. `yearly` trends have high search volume in the last year. `seasonal` trends have high upward growth in search volume over the last month and exhibit a seasonal recurring pattern (typically annual). One of: `growing`, `monthly`, `yearly`, `seasonal`.

ages

array

Optional

If set, filters the results to trends among users in the specified age range(s). Valid values: 18-24, 25-34, 35-44, 45-49, 50-54, 55-64, 65+. If unset, trends among all age groups are returned.

genders

array

Optional

If set, filters the results to trends among users who identify with the specified gender(s). Valid values: male, female, unknown (`unknown` includes users with unspecified or customized gender profile settings). If unset, trends among all genders are returned.

include_demographics

boolean

Optional

Whether to include the age and gender distribution for each keyword in the response. By default (`false`), the response does not include demographics data. Default: `false`.

include_keywords

array

Optional

If set, filters the results to top trends which include at least one of the specified keywords. If unset, no keyword filtering is applied. Between 1 and 50 keywords, each up to 100 characters. Example: ["recipes", "dessert"].

interests

array

Optional

If set, filters the results to trends among users who follow the specified interest categories. Valid values: animals, architecture, art, beauty, childrens_fashion, design, diy_and_crafts, education, electronics, entertainment, event_planning, finance, food_and_drinks, gardening, health, home_decor, mens_fashion, parenting, quotes, sport, travel, vehicles, wedding, womens_fashion. If unset, trends among all interests are returned.

limit

integer

Optional

The maximum number of trending keywords to return. Keywords are returned in trend-ranked order, so a limit of 50 returns the top 50 trends. Defaults to 50, maximum 50, minimum 1. Default: `50`.

normalize_against_group

boolean

Optional

Governs how the resulting time series data is normalized to a [0-100] scale. By default (`false`), the data is normalized independently for each keyword, so the peak search volume observation in each keyword's time series is 100. If set to `true`, the data is normalized as a group so the peak observation across all keywords in the response is 100, enabling comparison of relative search volume between multiple keywords. Default: `false`.

pinterest_user_account_analytics_get

Get user account analytics

Get account-level engagement analytics for the connected Pinterest user account over a date range. Returns a map of the requested metric types (e.g. IMPRESSION, SAVE, ENGAGEMENT) to their aggregated values, optionally split by app type, content ownership, source, or Pin format. Use this for account-wide engagement totals. Use pinterest_user_account_top_pins_list or pinterest_user_account_top_video_pins_list instead to see performance broken out by individual Pins.

Parameters

Name

Type

Required

Description

end_date

string

Required

End date of the metric report window (UTC), inclusive. Format: YYYY-MM-DD. Cannot be more than 90 days past start_date. Example: 2026-07-28.

start_date

string

Required

Start date of the metric report window (UTC), inclusive. Format: YYYY-MM-DD. Cannot be more than 90 days before today. Example: 2026-07-01.

ad_account_id

string

Optional

Unique identifier of a Business Access ad account to use as the operating account for this request, instead of the token user's own account. Only needed when using Pinterest Business Access to view or report on data owned by that ad account's user; the token user must hold an appropriate Business Access role on the ad account. Numeric string, up to 18 digits. Example: 549755885175.

app_types

string

Optional

Apps or devices to get data for, default is all. Valid values: ALL, MOBILE, TABLET, WEB. Defaults to ALL. One of: `ALL`, `MOBILE`, `TABLET`, `WEB`. Default: `ALL`.

content_type

string

Optional

Filter to paid or organic data. Default is all. Valid values: ALL, PAID, ORGANIC. Defaults to ALL. One of: `ALL`, `PAID`, `ORGANIC`. Default: `ALL`.

from_claimed_content

string

Optional

Filter on Pins that match your claimed domain. Valid values: OTHER, CLAIMED, BOTH. Defaults to BOTH. One of: `OTHER`, `CLAIMED`, `BOTH`. Default: `BOTH`.

metric_types

array

Optional

Metric types to get data for. Valid values: ENGAGEMENT, ENGAGEMENT_RATE, IMPRESSION, OUTBOUND_CLICK, OUTBOUND_CLICK_RATE, PIN_CLICK, PIN_CLICK_RATE, SAVE, SAVE_RATE. Defaults to all metric types when omitted. Example: ["IMPRESSION", "SAVE"].

pin_format

string

Optional

Pin formats to get data for, default is all. Valid values: ALL, ORGANIC_IMAGE, ORGANIC_PRODUCT, ORGANIC_VIDEO, ADS_STANDARD, ADS_PRODUCT, ADS_VIDEO, ADS_IDEA. Defaults to ALL. One of: `ALL`, `ORGANIC_IMAGE`, `ORGANIC_PRODUCT`, `ORGANIC_VIDEO`, `ADS_STANDARD`, `ADS_PRODUCT`, `ADS_VIDEO`, `ADS_IDEA`. Default: `ALL`.

source

string

Optional

Filter to activity from Pins created and saved by you, or activity created and saved by others from your claimed accounts. Default is all. Valid values: ALL, YOUR_PINS, OTHER_PINS. Defaults to ALL. One of: `ALL`, `YOUR_PINS`, `OTHER_PINS`. Default: `ALL`.

split_field

string

Optional

How to split the returned analytics data into groups. Valid values: NO_SPLIT, APP_TYPE, OWNED_CONTENT, SOURCE, PIN_FORMAT. Not including this parameter (or leaving the default) means the data is not split into groups. One of: `NO_SPLIT`, `APP_TYPE`, `OWNED_CONTENT`, `SOURCE`, `PIN_FORMAT`. Default: `NO_SPLIT`.

pinterest_user_account_businesses_list

List user account businesses

pinterest_user_account_following_boards_list

List user account following boards

pinterest_user_account_top_video_pins_list

List user account top video pins

List the connected Pinterest user account's top-performing video Pins (up to the top 50) over a date range, ranked by a chosen video metric. Returns per-metric data status plus, for each returned video Pin, its Pin ID and a map of the requested video metric values (e.g. VIDEO_MRC_VIEW, VIDEO_AVG_WATCH_TIME, VIDEO_10S_VIEW). Use this to see which video Pins are driving the most views and watch time. Use pinterest_user_account_top_pins_list instead for a metric set spanning all Pin formats, not just video.

Parameters

Name

Type

Required

Description

end_date

string

Required

End date of the metric report window (UTC), inclusive. Format: YYYY-MM-DD. Cannot be more than 90 days past start_date. Example: 2026-07-28.

sort_by

string

Required

Metric to sort the top video pins by. Valid values: SAVE, IMPRESSION, OUTBOUND_CLICK, VIDEO_MRC_VIEW, VIDEO_AVG_WATCH_TIME, VIDEO_V50_WATCH_TIME, QUARTILE_95_PERCENT_VIEW, VIDEO_10S_VIEW, VIDEO_START. One of: `SAVE`, `IMPRESSION`, `OUTBOUND_CLICK`, `VIDEO_MRC_VIEW`, `VIDEO_AVG_WATCH_TIME`, `VIDEO_V50_WATCH_TIME`, `QUARTILE_95_PERCENT_VIEW`, `VIDEO_10S_VIEW`, `VIDEO_START`.

start_date

string

Required

Start date of the metric report window (UTC), inclusive. Format: YYYY-MM-DD. Cannot be more than 90 days before today. Example: 2026-07-01.

ad_account_id

string

Optional

app_types

string

Optional

Apps or devices to get data for, default is all. Valid values: ALL, MOBILE, TABLET, WEB. Defaults to ALL. One of: `ALL`, `MOBILE`, `TABLET`, `WEB`. Default: `ALL`.

content_type

string

Optional

Filter to paid or organic data. Default is all. Valid values: ALL, PAID, ORGANIC. Defaults to ALL. One of: `ALL`, `PAID`, `ORGANIC`. Default: `ALL`.

created_in_last_n_days

integer

Optional

Limit results to pins created in the last "n" days. The only value the Pinterest API currently accepts is 30. Leave blank to apply no creation-date filter. One of: `30`.

from_claimed_content

string

Optional

Filter on Pins that match your claimed domain. Valid values: OTHER, CLAIMED, BOTH. Defaults to BOTH. One of: `OTHER`, `CLAIMED`, `BOTH`. Default: `BOTH`.

metric_types

array

Optional

Metric types to get data for. Valid values: IMPRESSION, SAVE, VIDEO_MRC_VIEW, VIDEO_AVG_WATCH_TIME, VIDEO_V50_WATCH_TIME, QUARTILE_95_PERCENT_VIEW, VIDEO_10S_VIEW, VIDEO_START, OUTBOUND_CLICK. Defaults to all metric types when omitted. Example: ["IMPRESSION", "SAVE"].

num_of_pins

integer

Optional

Number of top pins to include in the response. Defaults to 10. Maximum is 50, minimum is 1. Default: `10`.

pin_format

string

Optional

source

string

Optional

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// Pinterest tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["pinterest"], toolNames: [
    "pinterest_boards_list",
    "pinterest_pin_create",
    "pinterest_pins_analytics_list"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Create a Pin on my Fall Looks board from this image URL" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["pinterest"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Create a Pin on my Fall Looks board from this image URL" }],
  tools,
});

// Execute the tool call with the user's vaulted Pinterest OAuth token
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["pinterest"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Create a Pin on my Fall Looks board from this image URL" }],
  tools,
});

// Tool call runs with the user's vaulted Pinterest OAuth token
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["pinterest"] }, pageSize: 100,
});

const agent = new Agent({
  name: "social_media_agent",
  model: "gemini-2.5-pro",
  instruction: "Pinterest tools scoped to this user",
  tools,
});

await agent.run("Create a Pin on my Fall Looks board from this image URL");

Try these prompts

Copy any prompt into your agent. Each maps directly to a Pinterest tool. Click to copy, paste into your agent, done.

Pins and boards

Copy the prompt

Copied

Create a Pin on my Fall Looks board from this image URL.

Copy the prompt

Copied

Create a board called Holiday Gift Guide.

Copy the prompt

Copied

Move the scarf Pin to the Accessories section.

Analytics

Copy the prompt

Copied

Show my account engagement for the last 30 days.

Copy the prompt

Copied

Compare analytics for my 10 latest Pins.

Copy the prompt

Copied

List my top video Pins this month.

Catalogs and trends

Copy the prompt

Copied

Start ingesting our product catalog feed now.

Copy the prompt

Copied

Which catalog items have validation issues?

Copy the prompt

Copied

What are the top trending keywords in the US this week?

SEE HOW AUTH WORKS

Each user signs in to Pinterest once, and Scalekit stores and refreshes their tokens. Credentials stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other social media and marketing connectors.

GTM and RevOps Teams

Competitive intelligence briefing agent

Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared Pinterest token looks fine in a demo. In production every Pin and catalog change looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Pinterest today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Pinterest as the user or through a shared service account?

As the user. Each user signs in to Pinterest once, and Scalekit stores and refreshes their tokens. Pins, boards, and catalog changes the agent makes are attributed to that user in your audit trail, not a shared service account.

Where is the Pinterest OAuth token stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in Pinterest?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example the analytics and trends tools without pinterest_pin_create or pinterest_catalog_items_batch_create, which can delete catalog items in bulk. Scalekit also enforces scope checks before every API call.

What happens when a user revokes Pinterest access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent work on Business Account Pins and catalogs?

Yes, when the user has access. Pin, board, and catalog tools act on the authenticated account or on a Business Account the user can reach, and pinterest_user_account_businesses_list returns the business accounts linked to the connected user.