Focus · Pinterest
Typed Focus mode operations for Pinterest accounts, generated from the Pinterest focus module (same behaviour as the generic /accounts/{accountId}/focus routes).
focus_pinterest- Profile1
- Linked businesses1
- Followers1
- Following2
- Following boards1
- Interests1
- Websites4
- Boards7
- Board sections5
- Pins9
- Video uploads4
- Product tags4
- Account analytics1
- Top pins1
- Top video pins1
- Pin analytics1
- Video analytics1
- Audience insights1
- Trending keywords1
- Featured topics1
- Editorial articles1
- Trending product categories2
- Ad accounts3
- Businesses1
- Business members3
- Business partners2
- Business assets1
- Business invites3
Profile
Pinterest: Get Profile
/accounts/{accountId}/pinterest/profileAccount details and counts (followers, following, Pins, boards, monthly views). Pinterest does not allow profile edits via API. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/get Generic route: /v1/accounts/{accountId}/focus/profile.
Try it with MCPAsk your agent to call pinterest-profile-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
idstringread-onlyusernamestringread-onlyaccount_typestringread-onlyPINNERBUSINESS
business_namestring | nullread-onlyaboutstring | nullread-onlyprofile_imagestring (uri) | nullread-onlywebsite_urlstring (uri) | nullread-onlyfollower_countinteger | nullread-onlyfollowing_countinteger | nullread-onlypin_countinteger | nullread-onlyboard_countinteger | nullread-onlymonthly_viewsinteger | nullread-onlyResponses
Linked businesses
Pinterest: List Linked businesses
/accounts/{accountId}/pinterest/linked-businessesBusiness accounts linked to this Pinterest user. Cursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/linked_business_accounts/get Generic route: /v1/accounts/{accountId}/focus/linked-businesses.
Try it with MCPAsk your agent to call pinterest-linked-businesses-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
usernamestringread-onlyimage_small_urlstring (uri) | nullread-onlyimage_medium_urlstring (uri) | nullread-onlyimage_large_urlstring (uri) | nullread-onlyimage_xlarge_urlstring (uri) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Followers
Pinterest: List Followers
/accounts/{accountId}/pinterest/followersCursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/followers/list Generic route: /v1/accounts/{accountId}/focus/followers.
Try it with MCPAsk your agent to call pinterest-followers-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
usernamestringread-onlytypestringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Following
Pinterest: List Following
/accounts/{accountId}/pinterest/followingUsers this account follows. Follow is a single, user-initiated action (no automated follows). Cursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_following/get Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call pinterest-following-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
feed_typestringALLRANKEDCREATOR_ONLYRANKED_CREATOR_ONLY
explicit_followingbooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 2 item attributes
usernamestringread-onlytypestringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Follow user (Following)
/accounts/{accountId}/pinterest/following/followFollow user. Users this account follows. Follow is a single, user-initiated action (no automated follows). Requires scopes: user_accounts:read, user_accounts:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_following/get Generic route: /v1/accounts/{accountId}/focus/following.
Try it with MCPAsk your agent to call pinterest-following-follow (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
usernamestringrequiredReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Following boards
Pinterest: List Followed boards
/accounts/{accountId}/pinterest/following-boardsCursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/boards_user_follows/list Generic route: /v1/accounts/{accountId}/focus/following-boards.
Try it with MCPAsk your agent to call pinterest-following-boards-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
explicit_followingbooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlynamestringrequired≤ 180 characters
descriptionstring | nullprivacystringdefault: "PUBLIC"PUBLICPROTECTEDSECRET
urlstring (uri) | nullread-onlyBest-effort board URL
pin_countintegerread-onlyfollower_countintegerread-onlycollaborator_countintegerread-onlyis_ads_onlybooleandefault: falseimage_cover_urlstring (uri) | nullread-onlyowner_usernamestring | nullread-onlycreated_atstring (date-time) | nullread-onlyboard_pins_modified_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Interests
Pinterest: List Followed interests
/accounts/{accountId}/pinterest/interestsCursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/followed_interests Generic route: /v1/accounts/{accountId}/focus/interests.
Try it with MCPAsk your agent to call pinterest-interests-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
usernamestringDefaults to the connected account
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringread-onlykeystringread-onlynamestringread-onlycanonical_urlstring (uri) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Websites
Pinterest: List Claimed websites
/accounts/{accountId}/pinterest/websitesClaim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Cursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: /v1/accounts/{accountId}/focus/websites.
Try it with MCPAsk your agent to call pinterest-websites-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
websitestringrequiredDomain or domain/path
statusstring | nullread-onlyverified_atstring | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Create a Claimed websites item
/accounts/{accountId}/pinterest/websitesVerify (claim) the website once the verification code is in place. Claim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Requires scopes: user_accounts:read, user_accounts:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: /v1/accounts/{accountId}/focus/websites.
Try it with MCPAsk your agent to call pinterest-websites-create (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
websitestringrequiredverification_methodstringdefault: "METATAG"METATAGFILENAMEDNSTXT
Returns object
websitestringrequiredDomain or domain/path
statusstring | nullread-onlyverified_atstring | nullread-onlyResponses
Pinterest: Delete a Claimed websites item
/accounts/{accountId}/pinterest/websites/{itemId}Unclaim the website. Claim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Requires scopes: user_accounts:read, user_accounts:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: /v1/accounts/{accountId}/focus/websites.
Try it with MCPAsk your agent to call pinterest-websites-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Pinterest: Get verification code (Claimed websites)
/accounts/{accountId}/pinterest/websites/verification-codeMeta tag, HTML file, DNS TXT record and code to place on the site. Claim a website (meta tag, HTML file or DNS TXT) to unlock website analytics and attribution. Item id = website. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_websites/get Generic route: /v1/accounts/{accountId}/focus/websites.
Try it with MCPAsk your agent to call pinterest-websites-verification-code (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Boards
Pinterest: List Boards
/accounts/{accountId}/pinterest/boardsList boards, filter by privacy or search by name (search needs boards:read_secret). Boards (public, protected and secret), the default board used for publishing, and board Pins. Cursor pagination: pass next_cursor back as cursor. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: /v1/accounts/{accountId}/focus/boards.
Try it with MCPAsk your agent to call pinterest-boards-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
privacystringALLPUBLICPROTECTEDSECRETPUBLIC_AND_SECRET
qstringSearch boards by name
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 13 item attributes
idstringread-onlynamestringrequired≤ 180 characters
descriptionstring | nullprivacystringdefault: "PUBLIC"PUBLICPROTECTEDSECRET
urlstring (uri) | nullread-onlyBest-effort board URL
pin_countintegerread-onlyfollower_countintegerread-onlycollaborator_countintegerread-onlyis_ads_onlybooleandefault: falseimage_cover_urlstring (uri) | nullread-onlyowner_usernamestring | nullread-onlycreated_atstring (date-time) | nullread-onlyboard_pins_modified_atstring (date-time) | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Create a Boards item
/accounts/{accountId}/pinterest/boardsCreate a board (SECRET needs boards:write_secret). Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: /v1/accounts/{accountId}/focus/boards.
Try it with MCPAsk your agent to call pinterest-boards-create (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
namestringrequired≤ 180 characters
descriptionstringprivacystringdefault: "PUBLIC"PUBLICPROTECTEDSECRET
is_ads_onlybooleandefault: falseReturns object
idstringread-onlynamestringrequired≤ 180 characters
descriptionstring | nullprivacystringdefault: "PUBLIC"PUBLICPROTECTEDSECRET
urlstring (uri) | nullread-onlyBest-effort board URL
pin_countintegerread-onlyfollower_countintegerread-onlycollaborator_countintegerread-onlyis_ads_onlybooleandefault: falseimage_cover_urlstring (uri) | nullread-onlyowner_usernamestring | nullread-onlycreated_atstring (date-time) | nullread-onlyboard_pins_modified_atstring (date-time) | nullread-onlyResponses
Pinterest: Get a Boards item
/accounts/{accountId}/pinterest/boards/{itemId}Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: /v1/accounts/{accountId}/focus/boards.
Try it with MCPAsk your agent to call pinterest-boards-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
idstringread-onlynamestringrequired≤ 180 characters
descriptionstring | nullprivacystringdefault: "PUBLIC"PUBLICPROTECTEDSECRET
urlstring (uri) | nullread-onlyBest-effort board URL
pin_countintegerread-onlyfollower_countintegerread-onlycollaborator_countintegerread-onlyis_ads_onlybooleandefault: falseimage_cover_urlstring (uri) | nullread-onlyowner_usernamestring | nullread-onlycreated_atstring (date-time) | nullread-onlyboard_pins_modified_atstring (date-time) | nullread-onlyResponses
Pinterest: Update a Boards item
/accounts/{accountId}/pinterest/boards/{itemId}Rename, describe or change privacy (PUBLIC / SECRET; needs boards:write_secret). Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: /v1/accounts/{accountId}/focus/boards.
Try it with MCPAsk your agent to call pinterest-boards-update (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestring≤ 180 characters
descriptionstringprivacystringPUBLICSECRET
Returns object
idstringread-onlynamestringrequired≤ 180 characters
descriptionstring | nullprivacystringdefault: "PUBLIC"PUBLICPROTECTEDSECRET
urlstring (uri) | nullread-onlyBest-effort board URL
pin_countintegerread-onlyfollower_countintegerread-onlycollaborator_countintegerread-onlyis_ads_onlybooleandefault: falseimage_cover_urlstring (uri) | nullread-onlyowner_usernamestring | nullread-onlycreated_atstring (date-time) | nullread-onlyboard_pins_modified_atstring (date-time) | nullread-onlyResponses
Pinterest: Delete a Boards item
/accounts/{accountId}/pinterest/boards/{itemId}Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: /v1/accounts/{accountId}/focus/boards.
Try it with MCPAsk your agent to call pinterest-boards-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Pinterest: Set as default board (Boards)
/accounts/{accountId}/pinterest/boards/{itemId}/set-defaultDefault destination for Pins (Zernio PUT pinterest-boards). Returns metadata to persist on the account. Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: /v1/accounts/{accountId}/focus/boards.
Try it with MCPAsk your agent to call pinterest-boards-set-default (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Pinterest: Pins on board (Boards)
/accounts/{accountId}/pinterest/boards/{itemId}/pinsPins on board. Boards (public, protected and secret), the default board used for publishing, and board Pins. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards Generic route: /v1/accounts/{accountId}/focus/boards.
Try it with MCPAsk your agent to call pinterest-boards-pins (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
pin_metricsbooleancreative_typesarray of stringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Board sections
Pinterest: List Board sections
/accounts/{accountId}/pinterest/board-sectionsSections inside a board. Ids are <board_id>_<section_id>. Cursor pagination: pass next_cursor back as cursor. Requires scopes: boards:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: /v1/accounts/{accountId}/focus/board-sections.
Try it with MCPAsk your agent to call pinterest-board-sections-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
board_idstringrequiredReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 4 item attributes
idstringread-onlysection_idstringread-onlyboard_idstringrequirednamestringrequired1–180 characters
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Create a Board sections item
/accounts/{accountId}/pinterest/board-sectionsSections inside a board. Ids are <board_id>_<section_id>. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: /v1/accounts/{accountId}/focus/board-sections.
Try it with MCPAsk your agent to call pinterest-board-sections-create (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
board_idstringrequirednamestringrequired≤ 180 characters
Returns object
idstringread-onlysection_idstringread-onlyboard_idstringrequirednamestringrequired1–180 characters
Responses
Pinterest: Update a Board sections item
/accounts/{accountId}/pinterest/board-sections/{itemId}Sections inside a board. Ids are <board_id>_<section_id>. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: /v1/accounts/{accountId}/focus/board-sections.
Try it with MCPAsk your agent to call pinterest-board-sections-update (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
namestringrequired≤ 180 characters
Returns object
idstringread-onlysection_idstringread-onlyboard_idstringrequirednamestringrequired1–180 characters
Responses
Pinterest: Delete a Board sections item
/accounts/{accountId}/pinterest/board-sections/{itemId}Sections inside a board. Ids are <board_id>_<section_id>. Requires scopes: boards:read, boards:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: /v1/accounts/{accountId}/focus/board-sections.
Try it with MCPAsk your agent to call pinterest-board-sections-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Pinterest: Pins in section (Board sections)
/accounts/{accountId}/pinterest/board-sections/{itemId}/pinsPins in section. Sections inside a board. Ids are <board_id>_<section_id>. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/boards/operation/board_sections/list Generic route: /v1/accounts/{accountId}/focus/board-sections.
Try it with MCPAsk your agent to call pinterest-board-sections-pins (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Pins
Pinterest: List Pins
/accounts/{accountId}/pinterest/pinsList Pins (all, by board/section, private, or search with q; search needs *_secret scopes). Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Cursor pagination: pass next_cursor back as cursor. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
qstringSearch your Pins
board_idstringboard_section_idstringpin_filterstringexclude_nativeexclude_repinshas_been_promoted
creative_typesarray of stringinclude_protected_pinsbooleanpin_typestringPRIVATE
domainsarray of string≤ 100 items
pin_metricsbooleanInclude 90-day and lifetime metrics
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 20 item attributes
idstringread-onlytitlestring | null≤ 100 characters
descriptionstring | null≤ 800 characters
linkstring (uri) | null≤ 2048 characters
alt_textstring | null≤ 500 characters
board_idstringboard_section_idstring | nulldominant_colorstring | nullpattern ^#[0-9A-Fa-f]{6}$
media_typestring | nullread-onlyimagevideomultiple_imagesmultiple_videosmultiple_mixed
image_urlstring (uri) | nullread-onlycreative_typestring | nullread-onlyREGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP
ai_disclosuresarray of stringparent_pin_idstring | nullis_ownerbooleanread-onlyis_standardbooleanread-onlyis_productbooleanread-onlyhas_been_promotedbooleanread-onlypin_metricsobject | nullread-onlyurlstring (uri)read-onlycreated_atstring (date-time)read-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Create a Pins item
/accounts/{accountId}/pinterest/pinsPublish a Pin now (Socialit schedules; Pinterest has no publish_at). Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-create (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
board_idstringrequiredboard_section_idstringtitlestring≤ 100 characters
descriptionstring≤ 800 characters
linkstring (uri)≤ 2048 characters
alt_textstring≤ 500 characters
dominant_colorstringpattern ^#?[0-9A-Fa-f]{6}$
media_idsarray of stringSocialit media: 1 image, 2-5 images (carousel) or 1 video (+ optional cover image)
≤ 5 items
image_urlsarray of string (uri)≤ 5 items
video_urlstring (uri)pinterest_media_idstringProcessed video from Video uploads
cover_image_urlstring (uri)cover_image_key_frame_timeintegercarousel_itemsarray of object≤ 5 items
Show 3 item attributes
titlestringdescriptionstringlinkstring (uri)pin_typestringdefault: "auto"autoimagecarouselvideoproduct
is_affiliate_linkbooleanis_ai_generatedbooleanai_disclosuresarray of stringparent_pin_idstringis_standardbooleandefault: truefalse = simplified (idea-style) Pin, beta
Returns object
idstringread-onlytitlestring | null≤ 100 characters
descriptionstring | null≤ 800 characters
linkstring (uri) | null≤ 2048 characters
alt_textstring | null≤ 500 characters
board_idstringboard_section_idstring | nulldominant_colorstring | nullpattern ^#[0-9A-Fa-f]{6}$
media_typestring | nullread-onlyimagevideomultiple_imagesmultiple_videosmultiple_mixed
image_urlstring (uri) | nullread-onlycreative_typestring | nullread-onlyREGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP
ai_disclosuresarray of stringparent_pin_idstring | nullis_ownerbooleanread-onlyis_standardbooleanread-onlyis_productbooleanread-onlyhas_been_promotedbooleanread-onlypin_metricsobject | nullread-onlyurlstring (uri)read-onlycreated_atstring (date-time)read-onlyResponses
Pinterest: Get a Pins item
/accounts/{accountId}/pinterest/pins/{itemId}Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Query parameters
pin_metricsbooleanReturns object
idstringread-onlytitlestring | null≤ 100 characters
descriptionstring | null≤ 800 characters
linkstring (uri) | null≤ 2048 characters
alt_textstring | null≤ 500 characters
board_idstringboard_section_idstring | nulldominant_colorstring | nullpattern ^#[0-9A-Fa-f]{6}$
media_typestring | nullread-onlyimagevideomultiple_imagesmultiple_videosmultiple_mixed
image_urlstring (uri) | nullread-onlycreative_typestring | nullread-onlyREGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP
ai_disclosuresarray of stringparent_pin_idstring | nullis_ownerbooleanread-onlyis_standardbooleanread-onlyis_productbooleanread-onlyhas_been_promotedbooleanread-onlypin_metricsobject | nullread-onlyurlstring (uri)read-onlycreated_atstring (date-time)read-onlyResponses
Pinterest: Update a Pins item
/accounts/{accountId}/pinterest/pins/{itemId}Edit title, description, link, alt text, board/section, carousel slots, AI disclosure. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-update (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
titlestring≤ 100 characters
descriptionstring≤ 800 characters
linkstring (uri)≤ 2048 characters
alt_textstring≤ 500 characters
board_idstringboard_section_idstring | nullcarousel_slotsarray of objectShow 3 item attributes
titlestringdescriptionstringlinkstring (uri)ai_disclosuresarray of stringReturns object
idstringread-onlytitlestring | null≤ 100 characters
descriptionstring | null≤ 800 characters
linkstring (uri) | null≤ 2048 characters
alt_textstring | null≤ 500 characters
board_idstringboard_section_idstring | nulldominant_colorstring | nullpattern ^#[0-9A-Fa-f]{6}$
media_typestring | nullread-onlyimagevideomultiple_imagesmultiple_videosmultiple_mixed
image_urlstring (uri) | nullread-onlycreative_typestring | nullread-onlyREGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP
ai_disclosuresarray of stringparent_pin_idstring | nullis_ownerbooleanread-onlyis_standardbooleanread-onlyis_productbooleanread-onlyhas_been_promotedbooleanread-onlypin_metricsobject | nullread-onlyurlstring (uri)read-onlycreated_atstring (date-time)read-onlyResponses
Pinterest: Delete a Pins item
/accounts/{accountId}/pinterest/pins/{itemId}Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Pinterest: Save to board (Pins)
/accounts/{accountId}/pinterest/pins/{itemId}/saveSave (repin) to a board or section. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-save (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
board_idstringrequiredboard_section_idstringReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Pinterest: Move (Pins)
/accounts/{accountId}/pinterest/pins/{itemId}/moveMove to another board and/or section. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-move (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
board_idstringboard_section_idstring | nullReturns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Pinterest: Analytics (Pins)
/accounts/{accountId}/pinterest/pins/{itemId}/analyticsDaily analytics for this Pin (90-day window). Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-analytics (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
sincestring (date)untilstring (date)videobooleansplit_fieldstringNO_SPLITAPP_TYPE
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Pinterest: Lifetime metrics (Pins)
/accounts/{accountId}/pinterest/pins/{itemId}/metricsLifetime metrics. Every Pin on the account: create image, carousel, video and product Pins, edit, move, save to boards, delete. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/pins Generic route: /v1/accounts/{accountId}/focus/pins.
Try it with MCPAsk your agent to call pinterest-pins-metrics (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Video uploads
Pinterest: List Video uploads
/accounts/{accountId}/pinterest/video-uploadsPinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: /v1/accounts/{accountId}/focus/video-uploads.
Try it with MCPAsk your agent to call pinterest-video-uploads-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
media_idstringread-onlymedia_typestringread-onlyvideo
statusstringread-onlyregisteredprocessingsucceededfailed
upload_urlstring (uri) | nullread-onlyupload_parametersobject | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Create a Video uploads item
/accounts/{accountId}/pinterest/video-uploadsUpload a video (from Socialit media or a URL), or register only to upload directly to S3. Pinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Requires scopes: pins:read, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: /v1/accounts/{accountId}/focus/video-uploads.
Try it with MCPAsk your agent to call pinterest-video-uploads-create (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
media_idstringSocialit media id of the video
urlstring (uri)waitbooleandefault: falseWait until processing finishes
register_onlybooleandefault: falseReturn upload_url + upload_parameters for a direct upload
Returns object
media_idstringread-onlymedia_typestringread-onlyvideo
statusstringread-onlyregisteredprocessingsucceededfailed
upload_urlstring (uri) | nullread-onlyupload_parametersobject | nullread-onlyResponses
Pinterest: Get a Video uploads item
/accounts/{accountId}/pinterest/video-uploads/{itemId}Pinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Requires scopes: pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: /v1/accounts/{accountId}/focus/video-uploads.
Try it with MCPAsk your agent to call pinterest-video-uploads-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
media_idstringread-onlymedia_typestringread-onlyvideo
statusstringread-onlyregisteredprocessingsucceededfailed
upload_urlstring (uri) | nullread-onlyupload_parametersobject | nullread-onlyResponses
Pinterest: Wait for processing (Video uploads)
/accounts/{accountId}/pinterest/video-uploads/{itemId}/waitWait for processing. Pinterest video media uploads and their processing status. Use a succeeded media_id as pinterest_media_id when creating a Pin. Requires scopes: pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/media Generic route: /v1/accounts/{accountId}/focus/video-uploads.
Try it with MCPAsk your agent to call pinterest-video-uploads-wait (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
timeout_secondsintegerdefault: 601–300
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Product tags
Pinterest: List Product tags
/accounts/{accountId}/pinterest/product-tagsProduct Pins tagged onto a hero Pin (max 24 per request). Ids are <hero_pin_id>_<product_pin_id>. Cursor pagination: pass next_cursor back as cursor. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: /v1/accounts/{accountId}/focus/product-tags.
Try it with MCPAsk your agent to call pinterest-product-tags-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
pin_idstringrequiredHero Pin id
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 3 item attributes
idstringread-onlyhero_pin_idstringrequiredpin_idstringrequiredProduct Pin id
limitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Create a Product tags item
/accounts/{accountId}/pinterest/product-tagsProduct Pins tagged onto a hero Pin (max 24 per request). Ids are <hero_pin_id>_<product_pin_id>. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: /v1/accounts/{accountId}/focus/product-tags.
Try it with MCPAsk your agent to call pinterest-product-tags-create (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
hero_pin_idstringrequiredproduct_pin_idsarray of stringrequired1–24 items
Returns object
idstringread-onlyhero_pin_idstringrequiredpin_idstringrequiredProduct Pin id
Responses
Pinterest: Delete a Product tags item
/accounts/{accountId}/pinterest/product-tags/{itemId}Product Pins tagged onto a hero Pin (max 24 per request). Ids are <hero_pin_id>_<product_pin_id>. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: /v1/accounts/{accountId}/focus/product-tags.
Try it with MCPAsk your agent to call pinterest-product-tags-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Pinterest: Remove product tags (Product tags)
/accounts/{accountId}/pinterest/product-tags/remove-manyRemove product tags. Product Pins tagged onto a hero Pin (max 24 per request). Ids are <hero_pin_id>_<product_pin_id>. Destructive. Requires scopes: boards:read, pins:read, boards:write, pins:write. Network docs: https://developers.pinterest.com/docs/api/v5/#tag/product_tags Generic route: /v1/accounts/{accountId}/focus/product-tags.
Try it with MCPAsk your agent to call pinterest-product-tags-remove-many (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Body object
hero_pin_idstringrequiredproduct_pin_idsarray of stringrequired1–24 items
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Account analytics
Pinterest: Get Account analytics
/accounts/{accountId}/pinterest/account-analyticsImpressions, saves, Pin clicks, outbound clicks and engagement per day (90-day lookback), optionally split by app, source, owned content or Pin format. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/analytics Generic route: /v1/accounts/{accountId}/focus/account-analytics.
Try it with MCPAsk your agent to call pinterest-account-analytics-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Start date (UTC). Max 90 days back.
untilstring (date)End date (UTC). Defaults to today.
from_claimed_contentstringdefault: "BOTH"OTHERCLAIMEDBOTH
pin_formatstringdefault: "ALL"ALLORGANIC_IMAGEORGANIC_PRODUCTORGANIC_VIDEOADS_STANDARDADS_PRODUCTADS_VIDEOADS_IDEA
app_typesstringdefault: "ALL"ALLMOBILETABLETWEB
content_typestringdefault: "ALL"ALLPAIDORGANIC
sourcestringdefault: "ALL"ALLYOUR_PINSOTHER_PINS
split_fieldstringdefault: "NO_SPLIT"NO_SPLITAPP_TYPEOWNED_CONTENTSOURCEPIN_FORMAT
Returns object
reportstringwindowobjectShow 3 child attributes
start_datestring (date)end_datestring (date)clampedbooleanseriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumbertotalsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumbersplitsobjectResponses
Top pins
Pinterest: List Top Pins
/accounts/{accountId}/pinterest/top-pinsTop Pins (up to 50) by engagement, saves, impressions, outbound clicks or Pin clicks. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pins:read, user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/analytics/top_pins Generic route: /v1/accounts/{accountId}/focus/top-pins.
Try it with MCPAsk your agent to call pinterest-top-pins-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Start date (UTC). Max 90 days back.
untilstring (date)End date (UTC). Defaults to today.
from_claimed_contentstringdefault: "BOTH"OTHERCLAIMEDBOTH
pin_formatstringdefault: "ALL"ALLORGANIC_IMAGEORGANIC_PRODUCTORGANIC_VIDEOADS_STANDARDADS_PRODUCTADS_VIDEOADS_IDEA
app_typesstringdefault: "ALL"ALLMOBILETABLETWEB
content_typestringdefault: "ALL"ALLPAIDORGANIC
sourcestringdefault: "ALL"ALLYOUR_PINSOTHER_PINS
sort_bystringdefault: "IMPRESSION"ENGAGEMENTSAVEIMPRESSIONOUTBOUND_CLICKPIN_CLICK
num_of_pinsintegerdefault: 101–50
created_in_last_n_daysinteger30
include_pinsbooleandefault: trueFetch title and image for each Pin
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 21 item attributes
idstringread-onlyrankintegerpin_idstringtitlestring | nullimage_urlstring (uri) | nullurlstring (uri) | nullimpressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumberraw_metricsobjectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Top video pins
Pinterest: List Top video Pins
/accounts/{accountId}/pinterest/top-video-pinsTop video Pins (up to 50) with views, average watch time, total watch time, 95% views, 10-second views and starts. Cursor pagination: pass next_cursor back as cursor. Requires scopes: pins:read, user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/user_account/analytics/top_video_pins Generic route: /v1/accounts/{accountId}/focus/top-video-pins.
Try it with MCPAsk your agent to call pinterest-top-video-pins-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Start date (UTC). Max 90 days back.
untilstring (date)End date (UTC). Defaults to today.
from_claimed_contentstringdefault: "BOTH"OTHERCLAIMEDBOTH
pin_formatstringdefault: "ALL"ALLORGANIC_IMAGEORGANIC_PRODUCTORGANIC_VIDEOADS_STANDARDADS_PRODUCTADS_VIDEOADS_IDEA
app_typesstringdefault: "ALL"ALLMOBILETABLETWEB
content_typestringdefault: "ALL"ALLPAIDORGANIC
sourcestringdefault: "ALL"ALLYOUR_PINSOTHER_PINS
sort_bystringdefault: "IMPRESSION"SAVEIMPRESSIONOUTBOUND_CLICKVIDEO_MRC_VIEWVIDEO_AVG_WATCH_TIMEVIDEO_V50_WATCH_TIMEQUARTILE_95_PERCENT_VIEWVIDEO_10S_VIEWVIDEO_START
num_of_pinsintegerdefault: 101–50
created_in_last_n_daysinteger30
include_pinsbooleandefault: trueFetch title and image for each Pin
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 21 item attributes
idstringread-onlyrankintegerpin_idstringtitlestring | nullimage_urlstring (uri) | nullurlstring (uri) | nullimpressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumberraw_metricsobjectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pin analytics
Pinterest: Get Pin analytics
/accounts/{accountId}/pinterest/pin-analyticsDaily metrics for one Pin (90-day window), including video metrics and an APP_TYPE split. Requires scopes: boards:read, pins:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/pins/analytics Generic route: /v1/accounts/{accountId}/focus/pin-analytics.
Try it with MCPAsk your agent to call pinterest-pin-analytics-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
pin_idstringrequiredsincestring (date)Start date (UTC). Max 90 days back.
untilstring (date)End date (UTC). Defaults to today.
videobooleanRequest video metrics
split_fieldstringNO_SPLITAPP_TYPE
app_typesstringALLMOBILETABLETWEB
Returns object
reportstringpin_idstringwindowobjectShow 3 child attributes
start_datestring (date)end_datestring (date)clampedbooleanseriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumbertotalsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumberResponses
Video analytics
Pinterest: Get Video analytics
/accounts/{accountId}/pinterest/video-analyticsOrganic video Pin performance per day plus the top video Pins and their combined video metrics. Requires scopes: pins:read, user_accounts:read. Generic route: /v1/accounts/{accountId}/focus/video-analytics.
Try it with MCPAsk your agent to call pinterest-video-analytics-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
sincestring (date)Start date (UTC). Max 90 days back.
untilstring (date)End date (UTC). Defaults to today.
sort_bystringdefault: "VIDEO_MRC_VIEW"SAVEIMPRESSIONOUTBOUND_CLICKVIDEO_MRC_VIEWVIDEO_AVG_WATCH_TIMEVIDEO_V50_WATCH_TIMEQUARTILE_95_PERCENT_VIEWVIDEO_10S_VIEWVIDEO_START
num_of_pinsintegerdefault: 251–50
Returns object
reportstringwindowobjectShow 3 child attributes
start_datestring (date)end_datestring (date)clampedbooleanseriesarray of objectShow 2 item attributes
datestring (date)metricsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumbertotalsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumbertop_video_totalsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumbertop_video_pinsarray of objectShow 3 item attributes
rankintegerpin_idstringmetricsobjectShow 14 child attributes
impressionsnumbersavesnumberpin_clicksnumberoutbound_clicksnumberclicksnumberengagementsnumberengagement_ratenumbercommentsnumberlikesnumberprofile_viewsnumberfollower_changenumberviewsnumberwatch_time_secondsnumberavg_view_duration_secondsnumberResponses
Audience insights
Pinterest: Get Audience insights
/accounts/{accountId}/pinterest/audience-insightsAudience age, gender, country, metro, device and interest distribution (via the linked ad account; needs ads:read). Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/audience_insights/get Generic route: /v1/accounts/{accountId}/focus/audience-insights.
Try it with MCPAsk your agent to call pinterest-audience-insights-get (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
audience_insight_typestringdefault: "YOUR_TOTAL_AUDIENCE"YOUR_TOTAL_AUDIENCEYOUR_ENGAGED_AUDIENCEPINTEREST_TOTAL_AUDIENCE
ad_account_idstringReturns object
audience_typestringYOUR_TOTAL_AUDIENCEYOUR_ENGAGED_AUDIENCEPINTEREST_TOTAL_AUDIENCE
ad_account_idstringtotalinteger | nullsize_is_upper_boundboolean | nulldatestring (date) | nullagesarray of objectShow 3 item attributes
keystringnamestring | nullvaluenumberShare of audience 0..1
gendersarray of objectShow 3 item attributes
keystringnamestring | nullvaluenumberShare of audience 0..1
countriesarray of objectShow 3 item attributes
keystringnamestring | nullvaluenumberShare of audience 0..1
metrosarray of objectShow 3 item attributes
keystringnamestring | nullvaluenumberShare of audience 0..1
devicesarray of objectShow 3 item attributes
keystringnamestring | nullvaluenumberShare of audience 0..1
interestsarray of objectShow 4 item attributes
keystringnamestring | nullvaluenumberindexnumber | nullResponses
Trending keywords
Pinterest: List Trending keywords
/accounts/{accountId}/pinterest/trending-keywordsTop growing, monthly, yearly or seasonal search keywords by region, with optional demographic filters. Cursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trending_keywords/list Generic route: /v1/accounts/{accountId}/focus/trending-keywords.
Try it with MCPAsk your agent to call pinterest-trending-keywords-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
regionstringrequireddefault: "US"USCADEFRESITDE+AT+CHGB+IEIT+ES+PT+GR+MTPL+RO+HU+SK+CZSE+DK+FI+NONL+BE+LUARBRCOMXMX+AR+CO+CLAU+NZ
trend_typestringrequireddefault: "growing"growingmonthlyyearlyseasonal
interestsarray of stringgendersarray of stringagesarray of stringinclude_keywordsarray of string≤ 50 items
normalize_against_groupbooleaninclude_demographicsbooleanlimitintegerdefault: 501–50
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
keywordstringread-onlypct_growth_wowinteger | nullpct_growth_mominteger | nullpct_growth_yoyinteger | nulltime_seriesobject | nulldemographicsobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Featured topics
Pinterest: List Featured trends
/accounts/{accountId}/pinterest/featured-topicsEditorially featured trending topics per interest, with related searches and example Pins. Cursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_featured_topics/list Generic route: /v1/accounts/{accountId}/focus/featured-topics.
Try it with MCPAsk your agent to call pinterest-featured-topics-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
regionstringrequireddefault: "US"USGB+IECA
intereststringALLANIMALSARCHITECTUREARTBEAUTYDIY_AND_CRAFTSEDUCATIONEVENT_PLANNINGFASHIONFOOD_AND_DRINKSGARDENINGHEALTHHOME_DECORPARENTINGTRAVELWEDDING
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 9 item attributes
idstringread-onlytitlestringread-onlydescriptionstringread-onlyintereststringread-onlyALLANIMALSARCHITECTUREARTBEAUTYDIY_AND_CRAFTSEDUCATIONEVENT_PLANNINGFASHIONFOOD_AND_DRINKSGARDENINGHEALTHHOME_DECORPARENTINGTRAVELWEDDING
percent_growth_mominteger | nullrelated_searchesarray of stringrelated_interestsarray of stringpinsarray of objecttime_seriesobjectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Editorial articles
Pinterest: List Editorial articles
/accounts/{accountId}/pinterest/editorial-articlesPinterest editorial trend articles with their boards, Pins and related keywords. Cursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_editorial_articles/list Generic route: /v1/accounts/{accountId}/focus/editorial-articles.
Try it with MCPAsk your agent to call pinterest-editorial-articles-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
regionstringrequireddefault: "US"USGB+IECA
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
titlestringread-onlydescriptionstringread-onlyboard_urlstring (uri)read-onlypins_urlarray of string (uri)interestsarray of stringrelated_keywordsarray of objectlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Trending product categories
Pinterest: List Trending shopping categories
/accounts/{accountId}/pinterest/trending-product-categoriesTrending shopping product categories by region, vertical and demographic. Cursor pagination: pass next_cursor back as cursor. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_product_categories_trending/list Generic route: /v1/accounts/{accountId}/focus/trending-product-categories.
Try it with MCPAsk your agent to call pinterest-trending-product-categories-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
regionstringrequireddefault: "US"USGB+IECA
verticalsarray of stringagesarray of stringgendersarray of stringengagement_typestringdefault: "ENGAGEMENT"ENGAGEMENTOUTBOUND_CLICKSAVE
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 6 item attributes
pinterest_product_category_idintegerread-onlyproduct_categorystringread-onlyverticalsarray of stringengagement_typestringENGAGEMENTOUTBOUND_CLICKSAVE
pct_change_momintegerpercent_relative_volumeintegerlimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Category details (Trending shopping categories)
/accounts/{accountId}/pinterest/trending-product-categories/detailsCategory details. Trending shopping product categories by region, vertical and demographic. Requires scopes: user_accounts:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/trends_product_categories_trending/list Generic route: /v1/accounts/{accountId}/focus/trending-product-categories.
Try it with MCPAsk your agent to call pinterest-trending-product-categories-details (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
product_categoriesarray of stringrequired1–20 items
regionstringrequireddefault: "US"USGB+IECA
lookback_windowintegerdefault: 36590180365730
engagement_typestringENGAGEMENTOUTBOUND_CLICKSAVE
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Ad accounts
Pinterest: List Ad accounts (Business Access)
/accounts/{accountId}/pinterest/ad-accountsAd accounts this user can access. "Act as" makes Socialit call Pinterest with ad_account_id so you manage the client profile behind it. Cursor pagination: pass next_cursor back as cursor. Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list Generic route: /v1/accounts/{accountId}/focus/ad-accounts.
Try it with MCPAsk your agent to call pinterest-ad-accounts-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
include_shared_accountsbooleandefault: trueReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlynamestringread-onlycountrystring | nullread-onlycurrencystring | nullread-onlytime_zonestring | nullread-onlyownerobject | nullread-onlyShow 2 child attributes
idstringusernamestringpermissionsarray of stringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Act as this profile (Ad accounts (Business Access))
/accounts/{accountId}/pinterest/ad-accounts/{itemId}/act-asReturns metadata (operatingAdAccountId) to persist on the account. Ad accounts this user can access. "Act as" makes Socialit call Pinterest with ad_account_id so you manage the client profile behind it. Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list Generic route: /v1/accounts/{accountId}/focus/ad-accounts.
Try it with MCPAsk your agent to call pinterest-ad-accounts-act-as (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Pinterest: Stop acting as a client (Ad accounts (Business Access))
/accounts/{accountId}/pinterest/ad-accounts/stop-actingStop acting as a client. Ad accounts this user can access. "Act as" makes Socialit call Pinterest with ad_account_id so you manage the client profile behind it. Requires scopes: ads:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/ad_accounts/list Generic route: /v1/accounts/{accountId}/focus/ad-accounts.
Try it with MCPAsk your agent to call pinterest-ad-accounts-stop-acting (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Returns object
objectstringrequiredfocus_action_result
platformstringrequiredresourcestringrequiredactionstringrequiredidstring | nullrequiredresultanyThe action's return value (object, array, scalar or null)
Responses
Businesses
Pinterest: List Businesses
/accounts/{accountId}/pinterest/businessesBusinesses this user is a member of (Business Access employers). Cursor pagination: pass next_cursor back as cursor. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_employers Generic route: /v1/accounts/{accountId}/focus/businesses.
Try it with MCPAsk your agent to call pinterest-businesses-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 8 item attributes
idstringread-onlybusiness_rolesarray of stringread-onlycreated_by_businessobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_by_userobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_timeinteger | nullread-onlyuserobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullis_shared_partnerboolean | nullread-onlyassets_summaryobject | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Business members
Pinterest: List Business members
/accounts/{accountId}/pinterest/business-membersMembers of a business and their role. Ids are <business_id>_<member_id>. Cursor pagination: pass next_cursor back as cursor. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_members Generic route: /v1/accounts/{accountId}/focus/business-members.
Try it with MCPAsk your agent to call pinterest-business-members-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
business_idstringrequiredbusiness_rolesarray of stringassets_summarybooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlybusiness_rolesarray of stringread-onlycreated_by_businessobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_by_userobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_timeinteger | nullread-onlyuserobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullis_shared_partnerboolean | nullread-onlyassets_summaryobject | nullread-onlymember_idstringread-onlybusiness_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Update a Business members item
/accounts/{accountId}/pinterest/business-members/{itemId}Change the member role. Members of a business and their role. Ids are <business_id>_<member_id>. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_members Generic route: /v1/accounts/{accountId}/focus/business-members.
Try it with MCPAsk your agent to call pinterest-business-members-update (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Body object
business_rolestringrequiredEMPLOYEEBIZ_ADMIN
Returns object
idstringread-onlybusiness_rolesarray of stringread-onlycreated_by_businessobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_by_userobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_timeinteger | nullread-onlyuserobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullis_shared_partnerboolean | nullread-onlyassets_summaryobject | nullread-onlymember_idstringread-onlybusiness_idstringread-onlyResponses
Pinterest: Delete a Business members item
/accounts/{accountId}/pinterest/business-members/{itemId}Members of a business and their role. Ids are <business_id>_<member_id>. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_members Generic route: /v1/accounts/{accountId}/focus/business-members.
Try it with MCPAsk your agent to call pinterest-business-members-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Business partners
Pinterest: List Business partners
/accounts/{accountId}/pinterest/business-partnersPartner businesses with access to (or sharing) assets. Ids are <business_id>_<partner_id>. Cursor pagination: pass next_cursor back as cursor. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_partners Generic route: /v1/accounts/{accountId}/focus/business-partners.
Try it with MCPAsk your agent to call pinterest-business-partners-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
business_idstringrequiredpartner_typestringINTERNALEXTERNAL
assets_summarybooleanReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 10 item attributes
idstringread-onlybusiness_rolesarray of stringread-onlycreated_by_businessobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_by_userobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullcreated_timeinteger | nullread-onlyuserobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullis_shared_partnerboolean | nullread-onlyassets_summaryobject | nullread-onlypartner_idstringread-onlybusiness_idstringread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Delete a Business partners item
/accounts/{accountId}/pinterest/business-partners/{itemId}Partner businesses with access to (or sharing) assets. Ids are <business_id>_<partner_id>. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/business_partners Generic route: /v1/accounts/{accountId}/focus/business-partners.
Try it with MCPAsk your agent to call pinterest-business-partners-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultanyResponses
Business assets
Pinterest: List Business assets
/accounts/{accountId}/pinterest/business-assetsProfiles, ad accounts, asset groups and catalogs owned by or shared with a business. Cursor pagination: pass next_cursor back as cursor. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/business_assets/get Generic route: /v1/accounts/{accountId}/focus/business-assets.
Try it with MCPAsk your agent to call pinterest-business-assets-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
business_idstringrequiredasset_typestringdefault: "AD_ACCOUNT"AD_ACCOUNTPROFILEASSET_GROUPCATALOGCONSUMER
Returns object
objectstringrequiredlist
dataarray of objectrequiredShow 5 item attributes
asset_idstringread-onlyasset_typestringread-onlyAD_ACCOUNTPROFILEASSET_GROUPCATALOGCONSUMER
permissionsarray of stringread-onlyasset_group_infoobject | nullcatalog_infoobject | nulllimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Business invites
Pinterest: List Business invites
/accounts/{accountId}/pinterest/business-invitesPending member/partner invites and partner access requests. Ids are <business_id>_<invite_id>. Cursor pagination: pass next_cursor back as cursor. Requires scopes: biz_access:read. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/invites Generic route: /v1/accounts/{accountId}/focus/business-invites.
Try it with MCPAsk your agent to call pinterest-business-invites-list (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Query parameters
cursorstringPagination cursor (Pinterest bookmark)
limitintegerdefault: 251–250
business_idstringrequiredinvite_typestringMEMBER_INVITEPARTNER_INVITEPARTNER_REQUEST
invite_statusarray of stringis_memberbooleandefault: trueReturns object
objectstringrequiredlist
dataarray of objectrequiredShow 7 item attributes
idstringread-onlyinvite_idstringread-onlybusiness_idstringread-onlybusiness_rolesarray of stringread-onlyuserobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullinvite_dataobject | nullread-onlyShow 4 child attributes
invite_statusstringinvite_typestringinvite_expirationintegersent_atintegeris_received_inviteboolean | nullread-onlylimitinteger | nulltotalinteger | nullhas_morebooleanrequirednext_cursorstring | nullrequirednext_page_urlstring | nullprevious_page_urlstring | nullResponses
Pinterest: Create a Business invites item
/accounts/{accountId}/pinterest/business-invitesInvite members (usernames/emails) or partners, or request partner access. Pending member/partner invites and partner access requests. Ids are <business_id>_<invite_id>. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/invites Generic route: /v1/accounts/{accountId}/focus/business-invites.
Try it with MCPAsk your agent to call pinterest-business-invites-create (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
Headers
Idempotency-KeystringUnique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.
≤ 255 characters
Body object
business_idstringrequiredbusiness_rolestringrequiredEMPLOYEEBIZ_ADMINPARTNER
invite_typestringrequiredMEMBER_INVITEPARTNER_INVITEPARTNER_REQUEST
membersarray of string≤ 50 items
partnersarray of string≤ 50 items
Returns object
idstringread-onlyinvite_idstringread-onlybusiness_idstringread-onlybusiness_rolesarray of stringread-onlyuserobject | nullShow 3 child attributes
idstring | nullusernamestring | nullemailstring | nullinvite_dataobject | nullread-onlyShow 4 child attributes
invite_statusstringinvite_typestringinvite_expirationintegersent_atintegeris_received_inviteboolean | nullread-onlyResponses
Pinterest: Delete a Business invites item
/accounts/{accountId}/pinterest/business-invites/{itemId}Pending member/partner invites and partner access requests. Ids are <business_id>_<invite_id>. Requires scopes: biz_access:read, biz_access:write. Network docs: https://developers.pinterest.com/docs/api/v5/#operation/get/invites Generic route: /v1/accounts/{accountId}/focus/business-invites.
Try it with MCPAsk your agent to call pinterest-business-invites-delete (toolset focus_pinterest)Set up MCP
Path parameters
accountIdstringrequiredSocial account id (sa_…)
1–80 characters
itemIdstringrequiredThe network's id of the item
1–512 characters
Returns object
objectstringrequiredfocus_item
platformstringrequiredresourcestringrequiredidstring | nullrequireddeletedbooleanrequiredresultany