Pinterest MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Pinterest: 43 typed functions through one MCP server. No Pinterest API key needed.

Functions
43
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Pinterest

An MCP server for Pinterest alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/pinterest
Every site

One MCP server for Pinterest and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 28
  • getBoardRead one board: name, description, owner, pin count, follower count, section count, privacy and cover.

    Arguments

    NameTypeRequired
    usernamestringYes
    slugstringYes

    Returns PinterestBoardDetail

    interface PinterestBoardDetail {
      id: string;
      name: string;
      url: string;
      description?: string;
      owner?: { id: string; username: string; full_name?: string };
      pin_count?: number;
      follower_count?: number;
      section_count?: number;
      privacy?: string;
      image_cover_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/getBoard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.getBoard("surlatable", "fathers-day");
  • getCurrentUserWho the caller is signed in as.

    Arguments

    None.

    Returns PinterestUser

    interface PinterestUser {
      id: string;
      username: string;
      full_name: string;
      follower_count?: number;
      board_count?: number;
      pin_count?: number;
      is_verified_merchant?: boolean;
      image_large_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/getCurrentUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.getCurrentUser();
  • getHomeFeedThe caller's own personalised Pinterest home feed, same row shape as searchPins, with a bookmark for the next page.

    Arguments

    NameTypeRequired
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/getHomeFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.getHomeFeed();
  • getPinRead one pin in full: title, seo_title, the description Pinterest renders, the outbound link and link_domain, created_at, the pinner and the board it…

    Arguments

    NameTypeRequired
    idstringYes

    Returns PinterestPinDetail

    interface PinterestPinDetail {
      id: string;
      title?: string;
      seo_title?: string;
      description?: string;
      link?: string;
      link_domain?: { id: string };
      created_at?: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      repin_count?: number;
      share_count?: number;
      reaction_counts?: Record<string, number>;
      price_value?: number;
      price_currency?: string;
      carousel_data?: unknown;
      videos?: unknown;
      aggregated_pin_data?: { id: string };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/getPin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.getPin("1002684304554901551");
  • getProductRead the product behind a shoppable pin: price and currency, the merchant and the outbound buy link, availability, the aggregate rating and how many…

    Arguments

    NameTypeRequired
    idstringYes

    Returns PinterestProduct

    interface PinterestProduct {
      id: string;
      price?: number;
      currency?: string;
      rating?: number;
      review_count?: number;
      availability?: boolean;
      item_id?: string;
      item_set_id?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.getProduct("1002684304554901551");
  • getTopicRead one idea topic: its display name, its own key/slug, follower count, and whether it has related topics.

    Arguments

    NameTypeRequired
    topicIdstringYes

    Returns PinterestTopicDetail

    interface PinterestTopicDetail {
      id: string;
      name: string;
      key: string;
      slug: string;
      followerCount?: number;
      isFollowed?: boolean;
      hasRelated?: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/getTopic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.getTopic("918530398158");
  • getUserRead a person's or a brand's profile: id, full name, username, follower and following counts, how many pins and boards they have, whether they're a…

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns PinterestUser

    interface PinterestUser {
      id: string;
      username: string;
      full_name: string;
      follower_count?: number;
      board_count?: number;
      pin_count?: number;
      is_verified_merchant?: boolean;
      image_large_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/getUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.getUser("surlatable");
  • hidePinTell Pinterest the signed-in caller does not want to see a pin in their home feed.

    Arguments

    NameTypeRequired
    pinIdstringYes
    options{ undo?: boolean }No

    Returns { pinId: string; hidden: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/hidePin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.hidePin("1234567890");
  • listBoardPinsEvery pin inside a board, in the board's own order, with a bookmark for the next page.

    Arguments

    NameTypeRequired
    boardIdstringYes
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listBoardPins

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listBoardPins("180003385045887010");
  • listBoardSectionPinsThe pins inside one section of a board, taking the section id listBoardSections returns.

    Arguments

    NameTypeRequired
    sectionIdstringYes
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listBoardSectionPins

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listBoardSectionPins("5113343207027031305");
  • listBoardSectionsThe sections a board is divided into.

    Arguments

    NameTypeRequired
    boardIdstringYes

    Returns { sections: PinterestBoardSection[] }

    interface PinterestSectionPreviewPin {
      id: string;
      title?: string;
      link?: string;
    }
    
    interface PinterestBoardSection {
      id: string;
      title: string;
      slug: string;
      pin_count?: number;
      preview_pins?: PinterestSectionPreviewPin[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listBoardSections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listBoardSections("283445438986975093");
  • listConversationsThe caller's Pinterest inbox.

    Arguments

    None.

    Returns { conversations: PinterestConversation[] }

    interface PinterestUser {
      id: string;
      username: string;
      full_name: string;
      follower_count?: number;
      board_count?: number;
      pin_count?: number;
      is_verified_merchant?: boolean;
      image_large_url?: string;
    }
    
    interface PinterestConversation {
      id: string;
      created_at?: string;
      name?: string;
      board?: { id: string; name: string };
      emails?: string[];
      unread?: number;
      users?: PinterestUser[];
      last_message?: { text?: string; created_at?: string };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listConversations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listConversations();
  • listNotificationsThe caller's own notifications.

    Arguments

    NameTypeRequired
    options{ bookmark?: string; pageSize?: number }No

    Returns { notifications: PinterestNotification[]; bookmark: string | null }

    interface PinterestNotification {
      id: string;
      news_type?: string;
      header_text?: string;
      text?: string;
      display_mode?: string;
      unread?: boolean;
      created_at?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listNotifications

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listNotifications();
  • listTopicPinsThe best pins in a topic, Pinterest's editorial feed for that interest, which is the closest thing an anonymous caller has to the home feed.

    Arguments

    NameTypeRequired
    topicIdstringYes

    Returns { pins: PinterestIdeaPin[] }

    interface PinterestIdeaPin {
      id: string;
      images?: Record<string, { width: number; height: number; url: string }>;
      dominant_color?: string;
      videos?: unknown;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listTopicPins

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listTopicPins("918530398158");
  • listTopicsPinterest's own top-level idea topics.

    Arguments

    None.

    Returns { topics: PinterestTopic[] }

    interface PinterestTopic {
      id: string;
      name: string;
      url: string;
      isHoliday: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listTopics();
  • listUserBoardsEvery board a person has made public, with id, name, url, pin count and section count.

    Arguments

    NameTypeRequired
    usernamestringYes
    options{ bookmark?: string }No

    Returns { boards: PinterestBoard[]; bookmark: string | null }

    interface PinterestBoard {
      id: string;
      name: string;
      url: string;
      pin_count?: number;
      section_count?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listUserBoards

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listUserBoards("surlatable");
  • listUserCreatedPinsThe pins a person made themselves rather than saved from somebody else.

    Arguments

    NameTypeRequired
    usernamestringYes
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listUserCreatedPins

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listUserCreatedPins("surlatable");
  • listUserFollowersWho follows a person, page by page.

    Arguments

    NameTypeRequired
    usernamestringYes
    options{ bookmark?: string; pageSize?: number }No

    Returns { users: PinterestUser[]; bookmark: string | null }

    interface PinterestUser {
      id: string;
      username: string;
      full_name: string;
      follower_count?: number;
      board_count?: number;
      pin_count?: number;
      is_verified_merchant?: boolean;
      image_large_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listUserFollowers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listUserFollowers("surlatable");
  • listUserFollowingWho this person follows, people, boards and topics, as the caller's own signed-in session sees it.

    Arguments

    NameTypeRequired
    usernamestringYes
    options{ bookmark?: string }No

    Returns { users: PinterestUser[]; bookmark: string | null }

    interface PinterestUser {
      id: string;
      username: string;
      full_name: string;
      follower_count?: number;
      board_count?: number;
      pin_count?: number;
      is_verified_merchant?: boolean;
      image_large_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listUserFollowing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listUserFollowing("surlatable");
  • listUserSavedPinsThe pins a person has saved, newest first, across all their boards.

    Arguments

    NameTypeRequired
    usernamestringYes
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listUserSavedPins

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listUserSavedPins("surlatable");
  • listVisualObjectsThe objects Pinterest's own computer vision found inside a pin's image.

    Arguments

    NameTypeRequired
    idstringYes

    Returns { objects: PinterestVisualObject[] }

    interface PinterestVisualObject {
      x: number;
      y: number;
      w: number;
      h: number;
      label?: string;
      label_id?: number;
      score?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/listVisualObjects

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.listVisualObjects("11470174045893444");
  • reactToPinReact to a pin as the caller.

    Arguments

    NameTypeRequired
    pinIdstringYes
    options{ reactionType?: number; undo?: boolean }No

    Returns { pinId: string; reactionType: number; reacted: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/reactToPin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.reactToPin("1002684441946297892");
  • searchBoardsSearch for boards rather than pins.

    Arguments

    NameTypeRequired
    querystringYes
    options{ bookmark?: string }No

    Returns { boards: PinterestBoard[]; bookmark: string | null }

    interface PinterestBoard {
      id: string;
      name: string;
      url: string;
      pin_count?: number;
      section_count?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/searchBoards

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.searchBoards("espresso machine");
  • searchMyPinsSearch only inside the caller's own saved pins.

    Arguments

    NameTypeRequired
    querystringYes
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/searchMyPins

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.searchMyPins("espresso machine");
  • searchPinsSearch Pinterest the way a person types into its search box and get the pins back: grid_title, the outbound link and its domain, description, the…

    Arguments

    NameTypeRequired
    querystringYes
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/searchPins

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.searchPins("espresso machine");
  • searchUsersSearch for people and brands by name and get their account back.

    Arguments

    NameTypeRequired
    querystringYes
    options{ bookmark?: string }No

    Returns { users: PinterestUser[]; bookmark: string | null }

    interface PinterestUser {
      id: string;
      username: string;
      full_name: string;
      follower_count?: number;
      board_count?: number;
      pin_count?: number;
      is_verified_merchant?: boolean;
      image_large_url?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/searchUsers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.searchUsers("sur la table");
  • searchVideosSearch only the video pins.

    Arguments

    NameTypeRequired
    querystringYes
    options{ bookmark?: string }No

    Returns { pins: PinterestPin[]; bookmark: string | null }

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/searchVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.searchVideos("how to make espresso");
  • suggestSearchesAutocomplete a half-typed query the way Pinterest's search box does.

    Arguments

    NameTypeRequired
    termstringYes

    Returns { suggestions: PinterestSuggestion[] }

    interface PinterestSuggestion {
      type: "query" | "user";
      text: string;
      url?: string;
      username?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/suggestSearches

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.suggestSearches("espresso");
Act 15
  • commentOnPinLeave a comment on a pin as the caller.

    Arguments

    NameTypeRequired
    pinIdstringYes
    textstringYes
    options{ aggregatedPinDataId?: string }No

    Returns Record<string, unknown>

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/commentOnPin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.commentOnPin("<pinId>", "<text>");
  • createBoardMake a new board on the caller's account, public or secret, with a name and description.

    Arguments

    NameTypeRequired
    namestringYes
    options{ privacy?: "secret" | "public"; description?: string }No

    Returns PinterestBoard

    interface PinterestBoard {
      id: string;
      name: string;
      url: string;
      pin_count?: number;
      section_count?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/createBoard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.createBoard("<name>");
  • createPinCreate a new pin on the caller's account from an image and a destination link, with a title and description.

    Arguments

    NameTypeRequired
    boardIdstringYes
    pin{ imageUrl: string; link?: string; title?: string; description?: string; sectionId?: string }Yes

    Returns PinterestPin

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/createPin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.createPin("<boardId>", {});
  • deleteBoardDelete one of the caller's own boards.

    Arguments

    NameTypeRequired
    boardIdstringYes

    Returns { boardId: string; deleted: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/deleteBoard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.deleteBoard("<boardId>");
  • deletePinDelete a pin the caller created or saved.

    Arguments

    NameTypeRequired
    pinIdstringYes

    Returns { pinId: string; deleted: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/deletePin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.deletePin("<pinId>");
  • followBoardFollow a single board rather than everything its owner posts.

    Arguments

    NameTypeRequired
    boardIdstringYes

    Returns { boardId: string; following: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/followBoard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.followBoard("<boardId>");
  • followTopicFollow one of Pinterest's idea topics, which is what steers the caller's home feed.

    Arguments

    NameTypeRequired
    topicIdstringYes

    Returns { topicId: string; following: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/followTopic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.followTopic("<topicId>");
  • followUserFollow a person or a brand on the caller's behalf.

    Arguments

    NameTypeRequired
    userIdstringYes

    Returns { userId: string; following: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/followUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.followUser("<userId>");
  • savePinSave an existing pin to one of the caller's boards.

    Arguments

    NameTypeRequired
    pinIdstringYes
    boardIdstringYes
    options{ sectionId?: string; description?: string }No

    Returns PinterestPin

    interface PinterestPin {
      id: string;
      grid_title: string;
      link: string;
      pinner?: { username: string; full_name?: string };
      board?: { id: string; name: string };
      images?: Record<string, { width: number; height: number; url: string }>;
      product_metadata?: {
        price_val?: number;
        price_currency?: string;
        rating?: number;
        review_count?: number;
      };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/savePin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.savePin("<pinId>", "<boardId>");
  • sendPinSend a pin to somebody in a Pinterest message.

    Arguments

    NameTypeRequired
    pinIdstringYes
    recipients{ userIds?: string[]; emails?: string[] }Yes
    options{ message?: string }No

    Returns Record<string, unknown>

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/sendPin

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.sendPin("<pinId>", {});
  • unfollowBoardStop following a board.

    Arguments

    NameTypeRequired
    boardIdstringYes

    Returns { boardId: string; following: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/unfollowBoard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.unfollowBoard("<boardId>");
  • unfollowTopicStop following an idea topic.

    Arguments

    NameTypeRequired
    topicIdstringYes

    Returns { topicId: string; following: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/unfollowTopic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.unfollowTopic("<topicId>");
  • unfollowUserStop following a person or a brand.

    Arguments

    NameTypeRequired
    userIdstringYes

    Returns { userId: string; following: boolean }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/unfollowUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.unfollowUser("<userId>");
  • updateBoardRename a board, change its description, or flip it between public and secret.

    Arguments

    NameTypeRequired
    boardIdstringYes
    changes{ name?: string; description?: string; privacy?: "secret" | "public" }Yes

    Returns PinterestBoard

    interface PinterestBoard {
      id: string;
      name: string;
      url: string;
      pin_count?: number;
      section_count?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/updateBoard

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.updateBoard("<boardId>", {});
  • updateProfileEdit the caller's own profile.

    Arguments

    NameTypeRequired
    changes{ firstName?: string; lastName?: string; about?: string; websiteUrl?: string }Yes

    Returns Record<string, unknown>

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/pinterest/updateProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.pinterest.updateProfile({});

Use it from code