- Category: social media accounts
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 27
- Triggers: 0
- Slug:
PINTEREST - Version: 20261101_00
Tools
Create Board
Create Board
Create Board Section
Create Board Section
Create Pin
Create Pin
Slug:
PINTEREST_CREATE_PINCreate an image, carousel, or registered-video Pin on a Pinterest board. Production execution requires Pinterest Standard access: Trial apps are explicitly blocked from creating Pins on api.pinterest.com and must use a separately authenticated API Sandbox connection.Input Parameters
Official image URL, image Base64, carousel URL, carousel Base64, or registered-video source. The closed-beta pin_url source is not supported.
Optional creator declarations: AI_MODIFIED and/or SYNTHETIC_PERFORMER. Pinterest receives these under ai_disclosures.values.
Output
Delete Board
Delete Board
Delete Board Section
Delete Board Section
Delete Pin
Delete Pin
Get Account Analytics
Get Account Analytics
Slug:
PINTEREST_GET_ACCOUNT_ANALYTICSGet aggregate Pinterest account analytics over a UTC date range, with optional metric, content, platform, source, and split filters.Input Parameters
UTC report end date in YYYY-MM-DD format. It must be on or after start_date and no more than 90 days after it.
string ("ALL" | "ORGANIC_IMAGE" | "ORGANIC_PRODUCT" | "ORGANIC_VIDEO" | "ADS_STANDARD" | "ADS_PRODUCT" | "ADS_VIDEO" | "ADS_IDEA")
Pin format to include, or ALL for every supported format.
UTC report start date in YYYY-MM-DD format. Pinterest allows dates up to 90 days before today.
Group results by APP_TYPE, OWNED_CONTENT, SOURCE, or PIN_FORMAT. NO_SPLIT returns one aggregate bucket.
Metrics to return. Omit to request Pinterest’s default metric set; multiple values are sent as one comma-separated query value.
Filter Pins by claimed-domain relationship: OTHER, CLAIMED, or BOTH.
Output
Get Board
Get Board
Get Inspiration Trends
Get Inspiration Trends
Slug:
PINTEREST_GET_INSPIRATION_TRENDSGet Pinterest editorial trend articles or featured trend topics for a supported region.Input Parameters
string ("ALL" | "ANIMALS" | "ARCHITECTURE" | "ART" | "BEAUTY" | "DIY_AND_CRAFTS" | "EDUCATION" | "EVENT_PLANNING" | "FASHION" | "FOOD_AND_DRINKS" | "GARDENING" | "HEALTH" | "HOME_DECOR" | "PARENTING" | "TRAVEL" | "WEDDING")
Interest category for featured_topics. Leave as ALL when trend_source is editorial_articles.
Inspiration feed to return: editorial_articles for published trend articles or featured_topics for topic groups by interest.
Output
Get Keyword Trends
Get Keyword Trends
Slug:
PINTEREST_GET_KEYWORD_TRENDSFind Pinterest’s top growing, monthly, yearly, or seasonal search keywords for a supported market, optionally filtered to an audience or search terms.Input Parameters
string ("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")
required
Pinterest Trends market. Supported values include individual country codes such as US and grouped markets such as GB+IE.
Ranking timeframe: growing uses quarterly growth, monthly uses last-month volume, yearly uses last-year volume, and seasonal uses recurring growth.
Optional search terms; returned trends must include at least one term. Each term must contain 1-100 characters, with at most 50 terms.
When true, normalize all time series against the audience group’s shared peak so relative search volume can be compared between keywords.
Output
Get Media
Get Media
Get Pin Analytics
Get Pin Analytics
Slug:
PINTEREST_GET_PIN_ANALYTICSGet daily, summary, and lifetime analytics for one Pinterest Pin over a date range. Recent daily values may remain in PROCESSING status.Input Parameters
App or device data to include: ALL, MOBILE, TABLET, or WEB.
Pin metrics to return. Values are sent to Pinterest as one comma-separated query parameter.
Output
Get Product Trends
Get Product Trends
Slug:
PINTEREST_GET_PRODUCT_TRENDSGet currently growing shopping categories or detailed trend metrics for specified leaf product categories.Input Parameters
Use trending to discover growing shopping categories, or details to inspect specified leaf product categories. For details, reuse the product_category name returned by trending, not its numeric ID.
Metric to analyze: ENGAGEMENT, OUTBOUND_CLICK, or SAVE.
Required when mode is details: 1-20 leaf product categories to inspect. Pass each trending result’s product_category string, such as BAGS_AND_LUGGAGE; pinterest_product_category_id numeric values are not accepted. Omit in trending mode. Broad verticals such as BEAUTY are not valid product categories.
Output
Get Profile
Get Profile
Get Top Pins
Get Top Pins
Slug:
PINTEREST_GET_TOP_PINSReturn the connected account’s top Pinterest Pins or top video Pins ranked by an analytics metric.Input Parameters
Metric used to rank Pins. For pin_kind=all: ENGAGEMENT, SAVE, IMPRESSION, OUTBOUND_CLICK, or PIN_CLICK. For pin_kind=video: SAVE, IMPRESSION, OUTBOUND_CLICK, VIDEO_MRC_VIEW, VIDEO_AVG_WATCH_TIME, VIDEO_V50_WATCH_TIME, QUARTILE_95_PERCENT_VIEW, VIDEO_10S_VIEW, or VIDEO_START.
UTC report end date in YYYY-MM-DD format. It must be on or after start_date and no more than 90 days after it.
Ranking route to use: all for top Pins or video for top video Pins. The selected route determines the valid sort and metric values.
UTC report start date in YYYY-MM-DD format. It cannot be more than 90 days before today.
Optional metrics to include for each Pin. pin_kind=all accepts ENGAGEMENT, ENGAGEMENT_RATE, IMPRESSION, OUTBOUND_CLICK, OUTBOUND_CLICK_RATE, PIN_CLICK, PIN_CLICK_RATE, SAVE, and SAVE_RATE. pin_kind=video accepts IMPRESSION, SAVE, OUTBOUND_CLICK, VIDEO_MRC_VIEW, VIDEO_AVG_WATCH_TIME, VIDEO_V50_WATCH_TIME, QUARTILE_95_PERCENT_VIEW, VIDEO_10S_VIEW, and VIDEO_START. Values are sent as one comma-separated query value.
Filter Pins by claimed-domain ownership: OTHER, CLAIMED, or BOTH.
Output
Get Website Verification
Get Website Verification
Slug:
PINTEREST_GET_WEBSITE_VERIFICATIONGet the connected account’s website-claim verification methods and material. The response contains sensitive verification values.Input Parameters
Include the potentially large HTML verification file content; false returns only method metadata and filename.
Output
List Boards
List Boards
List Board Sections
List Board Sections
List Pins
List Pins
Slug:
PINTEREST_LIST_PINSList account Pins, Pins on a board, or Pins in a board section using one parameterized read tool. Account-level listing may omit secret-board Pins; provide board_id for reliable secret-board inventory.Input Parameters
Optional Pin creative-type filters for account or board listing. Pinterest does not support this filter for section listing.
Include available 90-day and lifetime Pin metrics for account or board listing. Pinterest does not support metrics for section listing.
Output
List Profile Resources
List Profile Resources
Slug:
PINTEREST_LIST_PROFILE_RESOURCESList the connected Pinterest profile’s followers, followed users, followed boards, claimed websites, or linked businesses, or list followed interests for a specified username.Input Parameters
Pinterest username required for followed_interests. Use Get Profile to discover the connected account’s username.
For following_users, select ALL, RANKED, CREATOR_ONLY, or RANKED_CREATOR_ONLY followees.
string ("followers" | "following_users" | "following_boards" | "followed_interests" | "websites" | "linked_businesses")
required
Profile resource to list: followers, following_users, following_boards, followed_interests, websites, or linked_businesses.
For following_users or following_boards, return only explicitly followed resources when true.
Output
Register Media
Register Media
Save Pin
Save Pin
Search Own Content
Search Own Content
Slug:
PINTEREST_SEARCH_OWN_CONTENTSearch the connected account’s own boards or Pins, including secret content when authorized. This does not search Pinterest’s global partner Pin index.Input Parameters
Text to search in the connected account’s content. Required when resource_type is pins; omit when browsing boards without a search term.
Maximum board results to return (1-250). Pinterest exposes no page-size parameter for Pin search, so this value is ignored when resource_type is pins.
Output
Update Board
Update Board
Update Board Section
Update Board Section
Update Pin
Update Pin
Slug:
PINTEREST_UPDATE_PINUpdate content on a Pin owned by the connected account or move it to another board or section. Provide at least one update field. Production Pin writes require Pinterest Standard access. This Organic action does not support Business Access ad-account delegation.Input Parameters
Numeric destination section ID when moving the Pin. Pass null to remove the Pin from its current section.
Replacement creator AI disclosures. Pass an empty list to clear the declarations; Pinterest receives this as ai_disclosures.values.