Integration · Marketing

Connect Claude & ChatGPT to Pinterest

Ask your AI which pins did best last month, to publish a new pin, or to tidy up a board. It works with your own pins, boards and board sections, reads account and pin analytics, and reports on ad accounts and campaigns. You can plan and review Pinterest content in the same chat.

Connect Pinterest free

Free plan, no credit card. Takes about a minute.

Try asking

“Which of my pins got the most outbound clicks last month?”
The AI lists your top pins for that date range, sorted by outbound clicks.
“Pin this product photo to my Summer Recipes board with a link to the recipe.”
It creates the pin on the board with title, description, link, alt text and the image URL. On a public board the pin is posted publicly.
“Create a secret board called Autumn Ideas with a section for drinks.”
It creates the board with privacy set to secret and adds the section.

What your AI can do

Pins and boards

Create, update, save and delete pins, create and update boards and sections, and search your own pins and boards.

Analytics

Read account analytics, analytics for a single pin and your top pins by impressions, saves, outbound clicks or engagement.

Ads reporting

List ad accounts and campaigns, and read spend and performance per ad account or campaign by day, week or month.

“How did my account do in the last 30 days?”
It reads account analytics such as impressions, saves, clicks and engagement for that period.
“How much did our ad campaigns spend last week?”
It lists your ad accounts and campaigns and reads campaign analytics with spend, impressions and clicks.
“Move my pasta pins to the Weeknight Dinners board.”
It searches your pins and updates each one with the new board.

262 tools for Pinterest

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

cancel_inviteMoves moneyCancel a invite (business id). Financial or irreversible action; may require approval. API summary: Cancel invites/requests.
create_accountChanges dataCreate a new account. API summary: Create ad account.
create_account_adChanges dataCreate a new ad for a account. Required: items. API summary: Create ads.
create_account_ad_groupChanges dataCreate a new ad group for a account. Required: items. API summary: Create ad groups.
create_account_ad_previewChanges dataCreate a new ad preview for a account. Required: body. API summary: Create ad preview with pin or image.
create_account_advertiser_defined_eventChanges dataCreate a new advertiser defined event for a account. Required: items. API summary: Create advertiser defined events.
create_account_audienceChanges dataCreate a new audience for a account. API summary: Create audience.
create_account_bid_floorChanges dataCreate a new bid floor for a account. Required: bid floor specs. API summary: Get bid floors.
create_account_campaignChanges dataCreate a new campaign for a account. Required: items. API summary: Create campaigns.
create_account_campaign_ad_previewChanges dataCreate a new campaign ad preview for a account. Required: items. API summary: Create ad preview records for one or more ad groups.
create_account_conversion_deletion_requestChanges dataCreate a new conversion deletion request for a account. Required: deletion targets. API summary: Create a conversion deletion request.
create_account_conversion_tagChanges dataCreate a new conversion tag for a account. Required: name. Search conversion tags first to avoid duplicates. API summary: Create conversion tag.
create_account_customerChanges dataCreate a new customer for a account. Required: name. Search customers first to avoid duplicates. API summary: Create customer lists.
create_account_eventChanges dataCreate a new event for a account. Required: data. API summary: Send conversions.
create_account_keywordChanges dataCreate a new keyword for a account. Required: keywords or parent id. API summary: Create keywords.
create_account_labelChanges dataCreate a new label for a account. Required: labels. API summary: Create labels.
create_account_leadChanges dataCreate a new lead for a account. Required: items. API summary: Create lead forms.
create_account_lead_leads_export_createChanges dataCreate a new lead for a account. Required: ad id, end date or start date. API summary: Create a request to export leads collected from a lead ad.
create_account_mmm_reportChanges dataCreate a new mmm report for a account. Required: columns, end date, granularity, level, report name or start date. API summary: Create a request for a Marketing Mix Modeling (MMM) report.
create_account_productChanges dataCreate a new product for a account. Required: ad group id or product group promotion. Search products first to avoid duplicates. API summary: Create product group promotions.
create_account_promotionChanges dataCreate a new promotion for a account. Required: items. API summary: Create promotions.
create_account_reportChanges dataCreate a new report for a account. Required: end date, granularity or start date. API summary: Create async request for an account analytics report.
create_account_scheduleChanges dataCreate a new schedule for a account. Required: items. API summary: Create schedules.
create_account_targeting_templateChanges dataCreate a new targeting template for a account. Required: name or targeting attributes. Search targeting templates first to avoid duplicates. API summary: Create targeting templates.
create_ad_group_dynamic_titleChanges dataCreate a new dynamic title for a ad group. Required: request id. API summary: Process dynamic titles CSV.
create_audience_sizingChanges dataCreate a new audience sizing. API summary: Get audience sizing.
create_boardChanges dataCreate a board with name (required), description and privacy (PUBLIC, PROTECTED or SECRET).
create_board_sectionChanges dataCreate a section on a board by board_id with a name.
create_business_hierarchy_accountChanges dataCreate a new account for a business hierarchy. Required: country, name or username. API summary: Create a Brand Account.
create_catalogChanges dataCreate a new catalog. Required: catalog type or name. API summary: Create catalog.
create_catalog_local_storeChanges dataCreate a new local store for a catalog. Required: items. API summary: Create local stores.
create_categoryChanges dataCreate a new category. Required: body. API summary: Create product group.
create_commerceChanges dataCreate a new commerce. API summary: Create commerce integration.
create_companyChanges dataCreate a new company. Required: invites. Search companies first to avoid duplicates. API summary: Update invite/request with an asset permission.
create_company_asset_access_requests_createChanges dataCreate a new company. Required: asset requests. Search companies first to avoid duplicates. API summary: Create a request to access an existing partner's assets.
create_company_asset_groupChanges dataCreate a new asset group for a company. Required: asset group description, asset group name or asset group types.
create_company_inviteChanges dataCreate a new invite for a company. Required: business role or invite type. API summary: Create invites or requests.
create_conversion_tokenDeletesCreate a new conversion token. Destructive action; may require approval. API summary: Generate OAuth access token for conversion API.
create_customer_list_documentChanges dataCreate a new document for a customer list. Required: operation or total parts. API summary: Create customer list upload.
create_customer_segmentsChanges dataCreate a new customer for a account. Required: audience ids or name. Search customers first to avoid duplicates. API summary: Create customer segments.
create_document_customerChanges dataCreate a new customer for a document. Search customers first to avoid duplicates. API summary: Run customer list upload.
create_eventChanges dataCreate a new event. Required: ad group id, event id, event name or event timestamp. API summary: Send Measurement Source Of Truth (MSOT) attributed conversion events.
create_feedChanges dataCreate a new feed. Required: body. API summary: Create feed.
create_feed_ingestChanges dataCreate a new ingest for a feed. API summary: Ingest feed items.
create_getChanges dataCreate a new get. Required: catalog id or items. API summary: Get item bid options (POST).
create_label_applyChanges dataCreate a new apply for a label. Required: entity ids. API summary: Apply label to entity.
create_label_removeChanges dataCreate a new remove for a label. Required: entity ids. API summary: Remove label from entities.
create_lead_form_leadChanges dataCreate a new lead for a lead form. Required: answers. API summary: Create lead form test data.
create_logChanges dataCreate a new log. Required: logs. API summary: Receives batched logs from integration applications.
create_mediumChanges dataCreate a new medium. Required: media type. API summary: Register media upload.
create_notificationChanges dataCreate a new notification. Required: items. API summary: Receive notifications from external partners.
create_orderChanges dataCreate a new order. Required: accepted terms id, billing contact email, billing contact firstname, billing contact lastname, billto billing address id or billto business address id. API summary: Create insertion order through SSIO.
create_pinChanges dataPublish a new pin to board_id with title, description, link, alt_text and media_source, e.g. {"source_type": "image_url", "url": "https://..."}. The pin is posted publicly on public boards.
create_pin_productVisible to othersCreate a new product for a pin. Required: product tags. Search products first to avoid duplicates. Has effects visible outside this system. API summary: Add product tags to pin.
create_productChanges dataCreate a new product. Required: columns, end date, granularity, level, report name or start date. Search products first to avoid duplicates. API summary: Create a request for a brand, category, SKU report.
create_product_catalogs_local_inventory_items_batch_operateVisible to othersCreate a new product. Required: operations. Search products first to avoid duplicates. Has effects visible outside this system. API summary: Operate on local inventory item batch.
create_product_groupsChanges dataCreate a new product. Required: items. Search products first to avoid duplicates. API summary: Create product groups.
create_product_items_batch_postVisible to othersCreate a new product. Required: body. Search products first to avoid duplicates. Has effects visible outside this system. API summary: Operate on item batch.
create_quoteChanges dataCreate a new quote. Required: items. API summary: Get campaign delivery estimates.
create_redeemChanges dataCreate a new redeem. Required: offer code hash or validate only. API summary: Redeem ad credits.
create_reportChanges dataCreate a new report. Required: body. API summary: Build catalogs report.
create_revokeDeletesCreate a new revoke. Required: token. Destructive action; may require approval. API summary: Revoke a token.
create_subscriptionChanges dataCreate a new subscription. Required: webhook url. API summary: Create lead ads subscription.
create_template_reportChanges dataCreate a new report for a template. API summary: Create async request for an analytics report using a template.
create_upsertVisible to othersCreate a new upsert. Has effects visible outside this system. API summary: Create/update ad entities in bulk.
create_userChanges dataCreate a new user. API summary: Verify website.
delete_account_advertiser_defined_eventsMoves moneyPermanently delete a advertiser defined event by ad account id. Financial or irreversible action; may require approval. API summary: Delete advertiser defined events.
delete_account_campaign_ad_previewsMoves moneyPermanently delete a campaign ad preview by ad account id. Financial or irreversible action; may require approval. API summary: Delete ad preview records for one or more ad groups.
delete_account_conversion_deletion_requestDeletesPermanently delete a conversion deletion request by request id. Destructive action; may require approval.
delete_account_promotionDeletesPermanently delete a promotion by promotion id. Destructive action; may require approval. API summary: Delete promotion by id.
delete_account_sandboxesMoves moneyPermanently delete a sandbox by ad account id. Financial or irreversible action; may require approval. API summary: Delete ads data for ad account in API Sandbox.
delete_assetsMoves moneyPermanently delete a asset by business id. Financial or irreversible action; may require approval. API summary: Delete partner access to asset.
delete_boardDeletesPermanently delete a board by board id. Destructive action; may require approval. API summary: Delete board.
delete_board_sectionDeletesPermanently delete a section by section id. Destructive action; may require approval. API summary: Delete board section.
delete_catalog_local_storesMoves moneyPermanently delete a local store by catalog id. Financial or irreversible action; may require approval. API summary: Delete local stores.
delete_categoryDeletesPermanently delete a category by category id. Destructive action; may require approval. API summary: Delete product group.
delete_commerceDeletesPermanently delete a commerce by external business id. Destructive action; may require approval. API summary: Delete commerce integration.
delete_companiesMoves moneyPermanently delete a company by business id. Financial or irreversible action; may require approval. API summary: Delete member access to asset.
delete_companies_delete_business_partnersMoves moneyPermanently delete a company by business id. Financial or irreversible action; may require approval. API summary: Terminate business partnerships.
delete_company_asset_groupsMoves moneyPermanently delete a asset group by business id. Financial or irreversible action; may require approval. API summary: Delete asset groups.
delete_company_usersMoves moneyPermanently delete a user by business id. Financial or irreversible action; may require approval. API summary: Terminate business memberships.
delete_feedDeletesPermanently delete a feed by feed id. Destructive action; may require approval. API summary: Delete feed.
delete_pinDeletesPermanently delete one of your pins by pin_id.
delete_product_tags_from_pinVisible to othersCreate a new product. Required: product tags. Search products first to avoid duplicates. Has effects visible outside this system. API summary: Delete product tags from pin.
delete_productsMoves moneyPermanently delete a product. Financial or irreversible action; may require approval. API summary: Delete product groups.
delete_subscriptionDeletesPermanently delete a subscription by subscription id. Destructive action; may require approval. API summary: Delete lead ads subscription.
delete_usersMoves moneyPermanently delete a user. Financial or irreversible action; may require approval. API summary: Unverify website.
download_bulkChanges dataDownload the document for a bulk. API summary: Get advertiser entities in bulk.
download_invoiceDownload the document for a invoice. API summary: Get download url for a billing invoice.
get_a_list_of_growing_shopping_product_categoriesList products. Optional filters: region, verticals, ages, genders or engagement type. API summary: Get a list of growing Shopping Product Categories.
get_accountGet the connected Pinterest account's profile: username, account type, follower and pin counts.
get_account_2Get one account by account id. API summary: Get ad account.
get_account_adGet one ad for a account by ad id. API summary: Get ad.
get_account_ad_groupGet one ad group for a account by ad group id. API summary: Get ad group.
get_account_analyticsGet the account's overall analytics (impressions, saves, clicks, engagement) between start_date and end_date (YYYY-MM-DD).
get_account_audienceGet one audience for a account by audience id. API summary: Get audience.
get_account_bulkGet one bulk for a account by bulk request id. API summary: Download advertiser entities in bulk.
get_account_campaignGet one campaign for a account by campaign id. API summary: Get campaign.
get_account_conversion_deletion_requestGet one conversion deletion request for a account by request id. API summary: Get a single conversion deletion request.
get_account_conversion_tagGet one conversion tag for a account by conversion tag id. API summary: Get conversion tag.
get_account_customerGet one customer for a account by customer id. API summary: Get customer list.
get_account_leadGet one lead for a account by lead id. API summary: Get lead form by id.
get_account_lead_leads_export_getGet one lead for a account by lead id. API summary: Get the lead export from the lead export create call.
get_account_order_lineGet one order line for a account by order line id. API summary: Get order line.
get_account_productGet one product for a account by product id. API summary: Get a product group promotion by id.
get_account_promotionGet one promotion for a account by promotion id. API summary: Get promotion by id.
get_ad_account_analyticsGet ad spend and performance for an ad account by ad_account_id between start_date and end_date, with columns (e.g. SPEND_IN_DOLLAR, IMPRESSION_1, CLICKTHROUGH_1) and granularity (TOTAL, DAY, WEEK, MONTH).
get_ad_analyticsList products. Optional filters: pin ids, start date, end date, ad ids, columns or granularity. API summary: Get ad analytics.
get_advertiser_brand_category_sku_reportList products. API summary: Get advertiser brand, category, SKU report.
get_boardGet one board by board_id.
get_campaign_analyticsGet performance for specific campaign_ids in an ad account between start_date and end_date, with columns and granularity.
get_catalogs_items_postChanges dataCreate a new product. Required: country, filters or language. Search products first to avoid duplicates. API summary: Get catalogs items (POST).
get_categoryGet one category by category id. API summary: Get product group.
get_commerceGet one commerce by external business id. API summary: Get commerce integration.
get_customer_list_documentGet one document for a customer list by customer list upload id. API summary: Get customer list upload.
get_dynamic_title_statusGet the current status of a dynamic title by ad group id. API summary: Get dynamic titles status.
get_feedGet one feed by feed id. API summary: Get feed.
get_insertion_order_status_by_pin_order_idGet the current status of a order by pin order id. API summary: Get insertion order status by pin order id.
get_integrationGet one integration by integration id. API summary: Get integration metadata.
get_interestGet one interest by interest id. API summary: Get interest details.
get_keyword_topGet one top for a keyword by trend type. Results are paginated. API summary: List trending keywords.
get_mediumGet one medium by media id. API summary: Get media upload details.
get_multiple_pin_analyticsList products. Optional filters: pin ids, start date, end date, app types, metric types or ad account id. API summary: Get multiple Pin analytics.
get_order_statusGet the current status of a order by ad account id. Results are paginated. API summary: Get insertion order status by ad account id.
get_pinGet one pin by pin_id, with title, description, link, board and media.
get_pin_analyticsGet analytics for one pin by pin_id between start_date and end_date (YYYY-MM-DD) for metric_types such as IMPRESSION, SAVE, PIN_CLICK, OUTBOUND_CLICK.
get_pins_analyticsList products. Optional filters: campaign id, pin ids, start date, end date, columns or granularity. API summary: Get pins analytics.
get_productGet one product by product id. API summary: Get item batch status.
get_product_by_product_group_filtersChanges dataGet one product. API summary: List products by filter.
get_product_category_detailsList products. Optional filters: product categories, region, lookback window or engagement type. API summary: Get product category details.
get_product_group_analyticsList products. Optional filters: start date, end date, product group ids, columns, granularity or click window days. API summary: Get product group analytics.
get_salesforce_account_details_including_bill_to_informationList accounts. API summary: Get Salesforce account details including bill-to information.
get_subscriptionGet one subscription by subscription id. API summary: Get lead ads subscription by ID.
get_supplemental_items_batch_statusGet one product by product id. API summary: Get supplemental items batch status.
get_targetingGet one targeting by targeting type. API summary: Get targeting options.
get_targeting_analytics_for_adsList targeting analytics. Optional filters: ad ids, start date, end date, targeting types, columns or granularity. API summary: Get targeting analytics for ads.
get_targeting_analytics_for_campaignsList targeting analytics. Optional filters: campaign ids, start date, end date, targeting types, columns or granularity. API summary: Get targeting analytics for campaigns.
get_user_verification_code_for_website_claimingList users. Optional filters: ad account id. API summary: Get user verification code for website claiming.
get_user_websitesList users. Optional filters: bookmark. Results are paginated. API summary: Get user websites.
list_account_ad_groupsList ad groups for a account. Optional filters: bookmark, order, campaign ids, ad group ids, entity statuses or translate interests to names. Results are paginated.
list_account_adsList ads for a account. Optional filters: bookmark, order, campaign ids, ad group ids, ad ids or entity statuses. Results are paginated.
list_account_advertiser_defined_eventsList advertiser defined events for a account. API summary: Get advertiser defined events.
list_account_audience_insightsList audience insights for a account. Optional filters: audience insight type. API summary: Get audience insights.
list_account_audiencesList audiences for a account. Optional filters: bookmark, order, ownership type or exclude nca. Results are paginated.
list_account_billing_profilesList billing profiles for a account. Optional filters: is active or bookmark. Results are paginated. API summary: Get billing profiles.
list_account_campaign_ad_previewsList campaign ad previews for a account. Optional filters: ad group ids. API summary: Fetch ad preview records for one or more ad groups.
list_account_conversion_deletion_requestsList conversion deletion requests for a account. Optional filters: bookmark or order. Results are paginated.
list_account_conversion_eqsList conversion eqs for a account. Optional filters: lookback period, source platform or ingestion source. API summary: Get event quality score (EQS).
list_account_customersList customers for a account. Optional filters: bookmark, order or exclude nca. Results are paginated. API summary: Get customer lists.
list_account_invoicesList invoices for a account. Optional filters: bookmark, order, sort, status, document type or start due date. Results are paginated. API summary: Get billing invoices.
list_account_keywordsList keywords for a account. Optional filters: campaign id, ad group id, ad group ids, match types or bookmark. Results are paginated. API summary: Get keywords.
list_account_labelsList labels for a account. Optional filters: campaign ids, label ids, entity statuses, label types or bookmark. Results are paginated.
list_account_leadsList leads for a account. Optional filters: bookmark or order. Results are paginated. API summary: List lead forms.
list_account_mmm_reportsList mmm reports for a account. API summary: Get advertiser Marketing Mix Modeling (MMM) report.
list_account_order_linesList order lines for a account. Optional filters: bookmark or order. Results are paginated. API summary: Get order lines.
list_account_productsList products for a account. Optional filters: bookmark, order, product group promotion ids, entity statuses or ad group id. Results are paginated. API summary: Get product group promotions.
list_account_promotion_applied_entitiesList promotion applied entities for a account. Optional filters: bookmark, order or promotion ids. Results are paginated. API summary: List of ad groups using promotions IDs.
list_account_promotionsList promotions for a account. Optional filters: bookmark or order. Results are paginated. API summary: Get promotions.
list_account_reportsList reports for a account. API summary: Get the account analytics report created by the async call.
list_account_schedulesList schedules for a account. Optional filters: bookmark, order, schedule statuses, schedule type or entity ids. Results are paginated. API summary: Get Schedules.
list_account_targeting_analyticsList targeting analytics for a account. Optional filters: start date, end date, targeting types, columns, granularity or click window days. API summary: Get targeting analytics for an ad account.
list_account_templatesList templates for a account. Optional filters: bookmark or order. Results are paginated.
list_account_terms_of_servicesList terms of services for a account. Optional filters: include html or tos type. API summary: Get terms of service.
list_accounts_ad_accounts_audiences_shared_accounts_listList accounts. Optional filters: audience id, account type or bookmark. Results are paginated. API summary: List accounts with access to an audience owned by an ad account.
list_accounts_business_account_audiences_shared_accounts_listList accounts. Optional filters: audience id, account type or bookmark. Results are paginated. API summary: List accounts with access to an audience owned by a business.
list_ad_account_countriesList ad account countries. API summary: Get ad accounts countries.
list_ad_accountsList the ad accounts this login can access. Use to find an ad_account_id for ad reporting.
list_ad_campaignsList ad campaigns in an ad account by ad_account_id, optionally filtered by entity_statuses.
list_asset_partnersList partners for a asset. Optional filters: start index or bookmark. Results are paginated. API summary: Get partners with access to asset.
list_asset_usersList users for a asset. Optional filters: start index, fetch system users or bookmark. Results are paginated. API summary: Get members with access to asset.
list_audiencesList audiences. API summary: Get audience insights scope and type.
list_board_pinsList the pins on a board by board_id.
list_board_sectionsList the sections of a board by board_id.
list_boardsList the account's boards, with IDs, names, privacy and pin counts. Use to find a board_id.
list_catalog_local_storesList local stores for a catalog. Optional filters: ids, ad account id or bookmark. Results are paginated.
list_catalogsList catalogs. Optional filters: ad account id or bookmark. Results are paginated.
list_categoriesList categories. Optional filters: id, feed id, catalog id, ad account id or bookmark. Results are paginated. API summary: List product groups.
list_category_productsList products for a category. Optional filters: ad account id. API summary: Get product counts.
list_companiesList companies for a company. Optional filters: assets summary, partner type, partner ids, start index, sort ascending or bookmark. Results are paginated. API summary: Get business partners.
list_company_assetsList assets for a company. Optional filters: permissions, child asset id, asset group id, asset type, start index or bookmark. Results are paginated. API summary: List business assets.
list_company_audiencesList audiences for a company. Optional filters: order or bookmark. Results are paginated. API summary: List received audiences for a business.
list_company_invitesList invites for a company. Optional filters: is member, invite status, invite type or bookmark. Results are paginated. API summary: Get invites/requests.
list_company_usersList users for a company. Optional filters: fetch system users, assets summary, business roles, member ids, start index or bookmark. Results are paginated. API summary: Get business members.
list_csvsList csvs. API summary: Get dynamic titles CSV download URL.
list_delivery_metricsList delivery metrics. Optional filters: report type. API summary: Get available metrics' definitions.
list_discountsList discounts. Optional filters: bookmark. Results are paginated. API summary: Get ads credit discounts.
list_documentsList documents. API summary: Get dynamic titles upload URL.
list_employersList employers. Optional filters: assets summary or bookmark. Results are paginated. API summary: List business employers for user.
list_featuredsList featureds. Optional filters: interest or region. API summary: Get featured topics.
list_feed_processing_resultsList processing results for a feed. Optional filters: ad account id or bookmark. Results are paginated. API summary: List feed processing results.
list_feedsList feeds. Optional filters: catalog id, ad account id or bookmark. Results are paginated.
list_followersList the accounts that follow the connected Pinterest account.
list_following_boardsList boards. Optional filters: ad account id, explicit following or bookmark. Results are paginated. API summary: List following boards.
list_followsList follows. Optional filters: bookmark. Results are paginated. API summary: List following interests.
list_integrationsList integrations. Optional filters: bookmark. Results are paginated. API summary: Get integration metadata list.
list_lead_form_questionsList lead form questions. API summary: Get lead form questions.
list_linked_businessesList companies. API summary: List linked businesses.
list_mediaList media. Optional filters: bookmark. Results are paginated. API summary: List media uploads.
list_metrics_ready_statesList metrics ready states. Optional filters: date. API summary: Get metrics ready state.
list_ocpm_eligiblesList ocpm eligibles. API summary: Get Ocpm eligible conversion tags.
list_order_linesList order lines. Optional filters: pin order id or bookmark. Results are paginated. API summary: Get Salesforce order lines by ad account id.
list_page_visitsList page visits. Optional filters: bookmark or order. Results are paginated. API summary: Get page visit conversion tags.
list_pin_productsList products for a pin. API summary: Get product tags for pin.
list_pinsList the account's own pins.
list_processing_result_ticketsList tickets for a processing result. Optional filters: item numbers, item validation issue, ad account id or bookmark. Results are paginated. API summary: List item issues.
list_productsList products. Optional filters: start date, end date, ad group ids, columns, granularity or click window days. API summary: Get ad group analytics.
list_products_by_product_groupList products for a category. Optional filters: ad account id, pin metrics or bookmark. Results are paginated. API summary: List products by product group.
list_products_trends_editorial_articles_listList products. Optional filters: region. API summary: Returns editorial articles for a given region.
list_relatedList related. Optional filters: terms. API summary: List related terms.
list_reportsList reports. Optional filters: ad account id. API summary: Get catalogs report.
list_section_pinsList pins for a section. Optional filters: ad account id or bookmark. Results are paginated. API summary: List Pins on board section.
list_statsList stats. Optional filters: ad account id, parameters or bookmark. Results are paginated. API summary: List report stats.
list_subscriptionsList subscriptions. Optional filters: bookmark. Results are paginated. API summary: Get lead ads subscriptions.
list_targeting_analyticsList targeting analytics. Optional filters: ad group ids, start date, end date, targeting types, columns or granularity. API summary: Get targeting analytics for ad groups.
list_top_pinsList the account's best-performing pins between start_date and end_date, sorted by sort_by (e.g. IMPRESSION, SAVE, OUTBOUND_CLICK, ENGAGEMENT).
list_top_video_pinsList top video pins. Optional filters: start date, end date, sort by, from claimed content, pin format or app types. API summary: Get user account top video pins analytics.
list_usersList users. Optional filters: ad account id, explicit following, feed type or bookmark. Results are paginated. API summary: List following.
save_pin_to_boardChanges dataSave an existing pin by pin_id to one of your boards (board_id, optional board_section_id).
search_account_conversion_tagsSearch conversion tags for a account by filter deleted. Use this to find existing conversion tags before creating a new conversion tag. API summary: List conversion tags.
search_account_customersSearch customers for a account by bookmark, order, include sizing or search query. Use this to find existing customers before creating a new customer. Results are paginated. API summary: List customer segments.
search_account_targeting_templatesSearch targeting templates for a account by bookmark, order, include sizing or search query. Use this to find existing targeting templates before creating a new targeting template. Results are paginated. API summary: List targeting templates.
search_available_filter_valuesSearch available filter values by catalog id, feed id, country, language or ad account id. Use this to find existing available filter values before creating a new available filter value. API summary: List available filter values.
search_boardsSearch the account's own boards by name with `query`.
search_member_companiesSearch companies for a member by asset type, start index, sort by, sort ascending, search by or search value. Use this to find existing companies before creating a new company. Results are paginated. API summary: Get assets assigned to a member.
search_metricsSearch metrics by country code or keywords. Use this to find existing metrics before creating a new metric. API summary: Get country's keyword metrics.
search_partner_assetsSearch assets for a partner by partner type, asset type, start index, sort by, sort ascending or search by. Use this to find existing assets before creating a new asset. Results are paginated. API summary: Get assets assigned to a partner or assets assigned by a partner.
search_pinsSearch the account's own pins by keyword with `query`.
search_pins_2Search pins by term, country code or bookmark. Use this to find existing pins before creating a new pin. Results are paginated. API summary: Search pins by a given search term.
search_productsChanges dataSearch products by ad account id. Use this to find existing products before creating a new product. API summary: Get local inventory items (POST).
search_suggestedsSearch suggesteds by term. Use this to find existing suggesteds before creating a new suggested. Results are paginated. API summary: List suggested terms.
submit_productVisible to othersSubmit a product. Has effects visible outside this system. API summary: Operate on item level bid options.
update_account_ad_groupsVisible to othersUpdate an existing ad group identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update ad groups.
update_account_adsVisible to othersUpdate an existing ad identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update ads.
update_account_advertiser_defined_eventsVisible to othersUpdate an existing advertiser defined event identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update advertiser defined events.
update_account_audienceChanges dataUpdate an existing audience identified by audience id. Only the fields you pass are changed. API summary: Update audience.
update_account_campaignsVisible to othersUpdate an existing campaign identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update campaigns.
update_account_customerChanges dataUpdate an existing customer identified by customer id. Only the fields you pass are changed. API summary: Update customer list.
update_account_customersVisible to othersUpdate an existing customer identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update customer segments.
update_account_keywordsVisible to othersUpdate an existing keyword identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update keywords.
update_account_labelsVisible to othersUpdate an existing label identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update labels.
update_account_leadsVisible to othersUpdate an existing lead identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update lead forms.
update_account_productsVisible to othersUpdate an existing product identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update product group promotions.
update_account_promotionsVisible to othersUpdate an existing promotion identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update promotions.
update_account_schedulesVisible to othersUpdate an existing schedule identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update schedules.
update_account_targeting_templatesVisible to othersUpdate an existing targeting template identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update targeting templates.
update_accountsVisible to othersUpdate an existing account identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update audience sharing between ad accounts.
update_assetsVisible to othersUpdate an existing asset identified by business id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Assign/Update partner asset permissions.
update_boardChanges dataUpdate a board by board_id: name, description or privacy.
update_board_sectionChanges dataUpdate an existing section identified by section id. Only the fields you pass are changed. API summary: Update board section.
update_business_hierarchy_accountChanges dataUpdate an existing account identified by account id. Only the fields you pass are changed. API summary: Update a Brand Account.
update_catalog_local_storesVisible to othersUpdate an existing local store identified by catalog id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update local stores.
update_categoryChanges dataUpdate an existing category identified by category id. Only the fields you pass are changed. API summary: Update single product group.
update_commerceChanges dataUpdate an existing commerce identified by external business id. Only the fields you pass are changed. API summary: Update commerce integration.
update_companiesVisible to othersUpdate an existing company identified by business id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Assign/Update member asset permissions.
update_company_asset_groupsVisible to othersUpdate an existing asset group identified by business id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update asset groups.
update_company_userChanges dataUpdate an existing user identified by user id. Only the fields you pass are changed. API summary: Update a system user information.
update_company_usersVisible to othersUpdate an existing user identified by business id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update member's business role.
update_feedChanges dataUpdate an existing feed identified by feed id. Only the fields you pass are changed. API summary: Update feed.
update_invitesVisible to othersUpdate an existing invite. Only the fields you pass are changed. Has effects visible outside this system. API summary: Accept or decline an invite/request.
update_ordersVisible to othersUpdate an existing order identified by ad account id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Edit insertion order through SSIO.
update_pinChanges dataUpdate a pin by pin_id: title, description, link, alt_text, or move it with board_id / board_section_id.
update_userChanges dataUpdate an existing user identified by username. API summary: Follow user.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Pinterest from the app list.
2
Paste your key
Paste the App ID and App secret key from your own Pinterest app, then sign in with your Pinterest login once. Log in to developers.pinterest.com with a Pinterest business account, go to My apps, accept the Developer Terms and submit an app request. Requests are reviewed each business day, and new apps start with Trial access. When approved, open My apps › Manage › Configure on your app and add the redirect URI https://heymyapps.com/oauth/callback.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Pinterest?

The AI can read your account, boards, board sections, pins and followers, search your own pins and boards, and read account, pin, top pin, ad account and campaign analytics. It can create and update pins, boards and sections, save a pin to a board, and delete a pin if you switch that tool on.

Does the AI see my Pinterest credentials?

No. Your Pinterest credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with analytics only. A pin created on a public board is visible to everyone, and deleting a pin is permanent, so both can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

Pinterest connects with OAuth, and this OAuth connection needs the HeyMyApps Pro plan. HeyMyApps also has a free plan with no credit card, but it does not include this connection. Paid plans bill per completed task. You also need your own Pinterest account.

Can the AI create or change Pinterest ads?

No. The ad tools are for reporting. The AI can list your ad accounts and campaigns and read spend and performance, but it cannot create, pause or edit campaigns.