Skip to content
Docs

Typed Focus mode operations for Pinterest accounts, generated from the Pinterest focus module (same behaviour as the generic /accounts/{accountId}/focus routes).

Base URLhttps://api.socialit.com/v1AuthenticationErrorsRate limits64 endpointsMCP toolset focus_pinterest

Profile

Pinterest: Get Profile

GET/accounts/{accountId}/pinterest/profile

Account 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.

Access: read

Try it with MCPAsk your agent to call pinterest-profile-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

idstringread-only
usernamestringread-only
account_typestringread-only

PINNERBUSINESS

business_namestring | nullread-only
aboutstring | nullread-only
profile_imagestring (uri) | nullread-only
website_urlstring (uri) | nullread-only
follower_countinteger | nullread-only
following_countinteger | nullread-only
pin_countinteger | nullread-only
board_countinteger | nullread-only
monthly_viewsinteger | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/profile
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Linked businesses

Pinterest: List Linked businesses

GET/accounts/{accountId}/pinterest/linked-businesses

Business 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.

Access: read

Try it with MCPAsk your agent to call pinterest-linked-businesses-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
usernamestringread-only
image_small_urlstring (uri) | nullread-only
image_medium_urlstring (uri) | nullread-only
image_large_urlstring (uri) | nullread-only
image_xlarge_urlstring (uri) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/linked-businesses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/linked-businesses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Followers

Pinterest: List Followers

GET/accounts/{accountId}/pinterest/followers

Cursor 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.

Access: read

Try it with MCPAsk your agent to call pinterest-followers-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
usernamestringread-only
typestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/followers
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Following

Pinterest: List Following

GET/accounts/{accountId}/pinterest/following

Users 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.

Access: read

Try it with MCPAsk your agent to call pinterest-following-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

feed_typestring

ALLRANKEDCREATOR_ONLYRANKED_CREATOR_ONLY

explicit_followingboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 2 item attributes
usernamestringread-only
typestringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/following
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Follow user (Following)

POST/accounts/{accountId}/pinterest/following/follow

Follow 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-following-follow (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

usernamestringrequired

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/following/follow
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/following/follow" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "string"
  }'
Response · 200

Following boards

Pinterest: List Followed boards

GET/accounts/{accountId}/pinterest/following-boards

Cursor 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.

Access: read

Try it with MCPAsk your agent to call pinterest-following-boards-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

explicit_followingboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
namestringrequired

≤ 180 characters

descriptionstring | null
privacystringdefault: "PUBLIC"

PUBLICPROTECTEDSECRET

urlstring (uri) | nullread-only

Best-effort board URL

pin_countintegerread-only
follower_countintegerread-only
collaborator_countintegerread-only
is_ads_onlybooleandefault: false
image_cover_urlstring (uri) | nullread-only
owner_usernamestring | nullread-only
created_atstring (date-time) | nullread-only
board_pins_modified_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/following-boards
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/following-boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Interests

Pinterest: List Followed interests

GET/accounts/{accountId}/pinterest/interests

Cursor 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.

Access: read

Try it with MCPAsk your agent to call pinterest-interests-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

usernamestring

Defaults to the connected account

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
keystringread-only
namestringread-only
canonical_urlstring (uri) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/interests
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/interests" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Websites

Pinterest: List Claimed websites

GET/accounts/{accountId}/pinterest/websites

Claim 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.

Access: read

Try it with MCPAsk your agent to call pinterest-websites-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
websitestringrequired

Domain or domain/path

statusstring | nullread-only
verified_atstring | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/websites
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/websites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Create a Claimed websites item

POST/accounts/{accountId}/pinterest/websites

Verify (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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-websites-create (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

websitestringrequired
verification_methodstringdefault: "METATAG"

METATAGFILENAMEDNSTXT

Returns object

websitestringrequired

Domain or domain/path

statusstring | nullread-only
verified_atstring | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/websites
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/websites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "website": "https://example.com",
    "verification_method": "METATAG"
  }'
Response · 201

Pinterest: Delete a Claimed websites item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-websites-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/websites/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/websites/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Get verification code (Claimed websites)

POST/accounts/{accountId}/pinterest/websites/verification-code

Meta 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-websites-verification-code (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/websites/verification-code
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/websites/verification-code" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Boards

Pinterest: List Boards

GET/accounts/{accountId}/pinterest/boards

List 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.

Access: readZernio: GET /v1/accounts/{accountId}/pinterest-boards

Try it with MCPAsk your agent to call pinterest-boards-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

privacystring

ALLPUBLICPROTECTEDSECRETPUBLIC_AND_SECRET

qstring

Search boards by name

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 13 item attributes
idstringread-only
namestringrequired

≤ 180 characters

descriptionstring | null
privacystringdefault: "PUBLIC"

PUBLICPROTECTEDSECRET

urlstring (uri) | nullread-only

Best-effort board URL

pin_countintegerread-only
follower_countintegerread-only
collaborator_countintegerread-only
is_ads_onlybooleandefault: false
image_cover_urlstring (uri) | nullread-only
owner_usernamestring | nullread-only
created_atstring (date-time) | nullread-only
board_pins_modified_atstring (date-time) | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/boards
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Create a Boards item

POST/accounts/{accountId}/pinterest/boards

Create 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.

Access: writeIdempotency-KeyZernio: POST /v1/accounts/{accountId}/pinterest-boards

Try it with MCPAsk your agent to call pinterest-boards-create (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

descriptionstring
privacystringdefault: "PUBLIC"

PUBLICPROTECTEDSECRET

is_ads_onlybooleandefault: false

Returns object

idstringread-only
namestringrequired

≤ 180 characters

descriptionstring | null
privacystringdefault: "PUBLIC"

PUBLICPROTECTEDSECRET

urlstring (uri) | nullread-only

Best-effort board URL

pin_countintegerread-only
follower_countintegerread-only
collaborator_countintegerread-only
is_ads_onlybooleandefault: false
image_cover_urlstring (uri) | nullread-only
owner_usernamestring | nullread-only
created_atstring (date-time) | nullread-only
board_pins_modified_atstring (date-time) | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/boards
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "privacy": "PUBLIC",
    "is_ads_only": false
  }'
Response · 201

Pinterest: Get a Boards item

GET/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.

Access: read

Try it with MCPAsk your agent to call pinterest-boards-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

idstringread-only
namestringrequired

≤ 180 characters

descriptionstring | null
privacystringdefault: "PUBLIC"

PUBLICPROTECTEDSECRET

urlstring (uri) | nullread-only

Best-effort board URL

pin_countintegerread-only
follower_countintegerread-only
collaborator_countintegerread-only
is_ads_onlybooleandefault: false
image_cover_urlstring (uri) | nullread-only
owner_usernamestring | nullread-only
created_atstring (date-time) | nullread-only
board_pins_modified_atstring (date-time) | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/boards/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Update a Boards item

PATCH/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.

Access: writeZernio: PUT /v1/accounts/{accountId}/pinterest-boards

Try it with MCPAsk your agent to call pinterest-boards-update (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestring

≤ 180 characters

descriptionstring
privacystring

PUBLICSECRET

Returns object

idstringread-only
namestringrequired

≤ 180 characters

descriptionstring | null
privacystringdefault: "PUBLIC"

PUBLICPROTECTEDSECRET

urlstring (uri) | nullread-only

Best-effort board URL

pin_countintegerread-only
follower_countintegerread-only
collaborator_countintegerread-only
is_ads_onlybooleandefault: false
image_cover_urlstring (uri) | nullread-only
owner_usernamestring | nullread-only
created_atstring (date-time) | nullread-only
board_pins_modified_atstring (date-time) | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/pinterest/boards/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "description": "string",
    "privacy": "PUBLIC"
  }'
Response · 200

Pinterest: Delete a Boards item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-boards-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/boards/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Set as default board (Boards)

POST/accounts/{accountId}/pinterest/boards/{itemId}/set-default

Default 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-boards-set-default (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/boards/{itemId}/set-default
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards/ITEM_ID/set-default" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Pinterest: Pins on board (Boards)

POST/accounts/{accountId}/pinterest/boards/{itemId}/pins

Pins 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-boards-pins (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

pin_metricsboolean
creative_typesarray of string

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/boards/{itemId}/pins
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards/ITEM_ID/pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 25,
    "pin_metrics": true,
    "creative_types": [
      "REGULAR"
    ]
  }'
Response · 200

Board sections

Pinterest: List Board sections

GET/accounts/{accountId}/pinterest/board-sections

Sections 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.

Access: read

Try it with MCPAsk your agent to call pinterest-board-sections-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

board_idstringrequired

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 4 item attributes
idstringread-only
section_idstringread-only
board_idstringrequired
namestringrequired

1–180 characters

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/board-sections
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/board-sections?board_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Create a Board sections item

POST/accounts/{accountId}/pinterest/board-sections

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-board-sections-create (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
namestringrequired

≤ 180 characters

Returns object

idstringread-only
section_idstringread-only
board_idstringrequired
namestringrequired

1–180 characters

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/board-sections
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/board-sections" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "board_id": "string",
    "name": "string"
  }'
Response · 201

Pinterest: Update a Board sections item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call pinterest-board-sections-update (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

namestringrequired

≤ 180 characters

Returns object

idstringread-only
section_idstringread-only
board_idstringrequired
namestringrequired

1–180 characters

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/pinterest/board-sections/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/board-sections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string"
  }'
Response · 200

Pinterest: Delete a Board sections item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-board-sections-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/board-sections/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/board-sections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Pins in section (Board sections)

POST/accounts/{accountId}/pinterest/board-sections/{itemId}/pins

Pins 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-board-sections-pins (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/board-sections/{itemId}/pins
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/board-sections/ITEM_ID/pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "cursor": "string",
    "limit": 25
  }'
Response · 200

Pins

Pinterest: List Pins

GET/accounts/{accountId}/pinterest/pins

List 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.

Access: read

Try it with MCPAsk your agent to call pinterest-pins-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

qstring

Search your Pins

board_idstring
board_section_idstring
pin_filterstring

exclude_nativeexclude_repinshas_been_promoted

creative_typesarray of string
include_protected_pinsboolean
pin_typestring

PRIVATE

domainsarray of string

≤ 100 items

pin_metricsboolean

Include 90-day and lifetime metrics

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 20 item attributes
idstringread-only
titlestring | null

≤ 100 characters

descriptionstring | null

≤ 800 characters

linkstring (uri) | null

≤ 2048 characters

alt_textstring | null

≤ 500 characters

board_idstring
board_section_idstring | null
dominant_colorstring | null

pattern ^#[0-9A-Fa-f]{6}$

media_typestring | nullread-only

imagevideomultiple_imagesmultiple_videosmultiple_mixed

image_urlstring (uri) | nullread-only
creative_typestring | nullread-only

REGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP

ai_disclosuresarray of string
parent_pin_idstring | null
is_ownerbooleanread-only
is_standardbooleanread-only
is_productbooleanread-only
has_been_promotedbooleanread-only
pin_metricsobject | nullread-only
urlstring (uri)read-only
created_atstring (date-time)read-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/pins
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Create a Pins item

POST/accounts/{accountId}/pinterest/pins

Publish 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-pins-create (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
board_section_idstring
titlestring

≤ 100 characters

descriptionstring

≤ 800 characters

linkstring (uri)

≤ 2048 characters

alt_textstring

≤ 500 characters

dominant_colorstring

pattern ^#?[0-9A-Fa-f]{6}$

media_idsarray of string

Socialit 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_idstring

Processed video from Video uploads

cover_image_urlstring (uri)
cover_image_key_frame_timeinteger
carousel_itemsarray of object

≤ 5 items

Show 3 item attributes
titlestring
descriptionstring
linkstring (uri)
pin_typestringdefault: "auto"

autoimagecarouselvideoproduct

is_affiliate_linkboolean
is_ai_generatedboolean
ai_disclosuresarray of string
parent_pin_idstring
is_standardbooleandefault: true

false = simplified (idea-style) Pin, beta

Returns object

idstringread-only
titlestring | null

≤ 100 characters

descriptionstring | null

≤ 800 characters

linkstring (uri) | null

≤ 2048 characters

alt_textstring | null

≤ 500 characters

board_idstring
board_section_idstring | null
dominant_colorstring | null

pattern ^#[0-9A-Fa-f]{6}$

media_typestring | nullread-only

imagevideomultiple_imagesmultiple_videosmultiple_mixed

image_urlstring (uri) | nullread-only
creative_typestring | nullread-only

REGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP

ai_disclosuresarray of string
parent_pin_idstring | null
is_ownerbooleanread-only
is_standardbooleanread-only
is_productbooleanread-only
has_been_promotedbooleanread-only
pin_metricsobject | nullread-only
urlstring (uri)read-only
created_atstring (date-time)read-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/pins
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "board_id": "string",
    "board_section_id": "string",
    "title": "string",
    "description": "string",
    "link": "https://example.com"
  }'
Response · 201

Pinterest: Get a Pins item

GET/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.

Access: read

Try it with MCPAsk your agent to call pinterest-pins-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Query parameters

pin_metricsboolean

Returns object

idstringread-only
titlestring | null

≤ 100 characters

descriptionstring | null

≤ 800 characters

linkstring (uri) | null

≤ 2048 characters

alt_textstring | null

≤ 500 characters

board_idstring
board_section_idstring | null
dominant_colorstring | null

pattern ^#[0-9A-Fa-f]{6}$

media_typestring | nullread-only

imagevideomultiple_imagesmultiple_videosmultiple_mixed

image_urlstring (uri) | nullread-only
creative_typestring | nullread-only

REGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP

ai_disclosuresarray of string
parent_pin_idstring | null
is_ownerbooleanread-only
is_standardbooleanread-only
is_productbooleanread-only
has_been_promotedbooleanread-only
pin_metricsobject | nullread-only
urlstring (uri)read-only
created_atstring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/pins/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Update a Pins item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call pinterest-pins-update (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The 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_idstring
board_section_idstring | null
carousel_slotsarray of object
Show 3 item attributes
titlestring
descriptionstring
linkstring (uri)
ai_disclosuresarray of string

Returns object

idstringread-only
titlestring | null

≤ 100 characters

descriptionstring | null

≤ 800 characters

linkstring (uri) | null

≤ 2048 characters

alt_textstring | null

≤ 500 characters

board_idstring
board_section_idstring | null
dominant_colorstring | null

pattern ^#[0-9A-Fa-f]{6}$

media_typestring | nullread-only

imagevideomultiple_imagesmultiple_videosmultiple_mixed

image_urlstring (uri) | nullread-only
creative_typestring | nullread-only

REGULARVIDEOSHOPPINGCAROUSELMAX_VIDEOSHOP_THE_PINCOLLECTIONIDEASHOWCASEQUIZCOLLAGEMAX_WIDTH_REGULAR_COLLECTIONMAX_WIDTH_VIDEO_COLLECTIONAPP

ai_disclosuresarray of string
parent_pin_idstring | null
is_ownerbooleanread-only
is_standardbooleanread-only
is_productbooleanread-only
has_been_promotedbooleanread-only
pin_metricsobject | nullread-only
urlstring (uri)read-only
created_atstring (date-time)read-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/pinterest/pins/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "string",
    "description": "string",
    "link": "https://example.com",
    "alt_text": "string",
    "board_id": "string"
  }'
Response · 200

Pinterest: Delete a Pins item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-pins-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/pins/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Save to board (Pins)

POST/accounts/{accountId}/pinterest/pins/{itemId}/save

Save (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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-pins-save (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
board_section_idstring

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/pins/{itemId}/save
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID/save" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "board_id": "string",
    "board_section_id": "string"
  }'
Response · 200

Pinterest: Move (Pins)

POST/accounts/{accountId}/pinterest/pins/{itemId}/move

Move 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-pins-move (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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_idstring
board_section_idstring | null

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/pins/{itemId}/move
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID/move" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "board_id": "string",
    "board_section_id": "string"
  }'
Response · 200

Pinterest: Analytics (Pins)

POST/accounts/{accountId}/pinterest/pins/{itemId}/analytics

Daily 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-pins-analytics (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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)
videoboolean
split_fieldstring

NO_SPLITAPP_TYPE

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/pins/{itemId}/analytics
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID/analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "since": "2026-10-13",
    "until": "2026-10-13",
    "video": true,
    "split_field": "NO_SPLIT"
  }'
Response · 200

Pinterest: Lifetime metrics (Pins)

POST/accounts/{accountId}/pinterest/pins/{itemId}/metrics

Lifetime 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-pins-metrics (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/pins/{itemId}/metrics
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID/metrics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Video uploads

Pinterest: List Video uploads

GET/accounts/{accountId}/pinterest/video-uploads

Pinterest 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.

Access: read

Try it with MCPAsk your agent to call pinterest-video-uploads-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
media_idstringread-only
media_typestringread-only

video

statusstringread-only

registeredprocessingsucceededfailed

upload_urlstring (uri) | nullread-only
upload_parametersobject | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/video-uploads
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-uploads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Create a Video uploads item

POST/accounts/{accountId}/pinterest/video-uploads

Upload 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-video-uploads-create (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstring

Socialit media id of the video

urlstring (uri)
waitbooleandefault: false

Wait until processing finishes

register_onlybooleandefault: false

Return upload_url + upload_parameters for a direct upload

Returns object

media_idstringread-only
media_typestringread-only

video

statusstringread-only

registeredprocessingsucceededfailed

upload_urlstring (uri) | nullread-only
upload_parametersobject | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/video-uploads
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-uploads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "media_id": "string",
    "url": "https://example.com",
    "wait": false,
    "register_only": false
  }'
Response · 201

Pinterest: Get a Video uploads item

GET/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.

Access: read

Try it with MCPAsk your agent to call pinterest-video-uploads-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

media_idstringread-only
media_typestringread-only

video

statusstringread-only

registeredprocessingsucceededfailed

upload_urlstring (uri) | nullread-only
upload_parametersobject | nullread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/video-uploads/{itemId}
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-uploads/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Wait for processing (Video uploads)

POST/accounts/{accountId}/pinterest/video-uploads/{itemId}/wait

Wait 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-video-uploads-wait (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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: 60

1–300

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/video-uploads/{itemId}/wait
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-uploads/ITEM_ID/wait" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "timeout_seconds": 60
  }'
Response · 200

Product tags

Pinterest: List Product tags

GET/accounts/{accountId}/pinterest/product-tags

Product 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.

Access: read

Try it with MCPAsk your agent to call pinterest-product-tags-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

pin_idstringrequired

Hero Pin id

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 3 item attributes
idstringread-only
hero_pin_idstringrequired
pin_idstringrequired

Product Pin id

limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/product-tags
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/product-tags?pin_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Create a Product tags item

POST/accounts/{accountId}/pinterest/product-tags

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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-product-tags-create (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
product_pin_idsarray of stringrequired

1–24 items

Returns object

idstringread-only
hero_pin_idstringrequired
pin_idstringrequired

Product Pin id

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/product-tags
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/product-tags" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "hero_pin_id": "string",
    "product_pin_ids": [
      "string"
    ]
  }'
Response · 201

Pinterest: Delete a Product tags item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-product-tags-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/product-tags/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/product-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Remove product tags (Product tags)

POST/accounts/{accountId}/pinterest/product-tags/remove-many

Remove 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.

Access: write

Try it with MCPAsk your agent to call pinterest-product-tags-remove-many (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Body object

hero_pin_idstringrequired
product_pin_idsarray of stringrequired

1–24 items

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/product-tags/remove-many
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/product-tags/remove-many" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "hero_pin_id": "string",
    "product_pin_ids": [
      "string"
    ]
  }'
Response · 200

Account analytics

Pinterest: Get Account analytics

GET/accounts/{accountId}/pinterest/account-analytics

Impressions, 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.

Access: read

Try it with MCPAsk your agent to call pinterest-account-analytics-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social 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

reportstring
windowobject
Show 3 child attributes
start_datestring (date)
end_datestring (date)
clampedboolean
seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
totalsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
splitsobject

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/account-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/account-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Top pins

Pinterest: List Top Pins

GET/accounts/{accountId}/pinterest/top-pins

Top 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.

Access: read

Try it with MCPAsk your agent to call pinterest-top-pins-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social 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: 10

1–50

created_in_last_n_daysinteger

30

include_pinsbooleandefault: true

Fetch title and image for each Pin

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 21 item attributes
idstringread-only
rankinteger
pin_idstring
titlestring | null
image_urlstring (uri) | null
urlstring (uri) | null
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
raw_metricsobject
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/top-pins
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/top-pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Top video pins

Pinterest: List Top video Pins

GET/accounts/{accountId}/pinterest/top-video-pins

Top 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.

Access: read

Try it with MCPAsk your agent to call pinterest-top-video-pins-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social 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: 10

1–50

created_in_last_n_daysinteger

30

include_pinsbooleandefault: true

Fetch title and image for each Pin

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 21 item attributes
idstringread-only
rankinteger
pin_idstring
titlestring | null
image_urlstring (uri) | null
urlstring (uri) | null
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
raw_metricsobject
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/top-video-pins
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/top-video-pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pin analytics

Pinterest: Get Pin analytics

GET/accounts/{accountId}/pinterest/pin-analytics

Daily 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.

Access: read

Try it with MCPAsk your agent to call pinterest-pin-analytics-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

pin_idstringrequired
sincestring (date)

Start date (UTC). Max 90 days back.

untilstring (date)

End date (UTC). Defaults to today.

videoboolean

Request video metrics

split_fieldstring

NO_SPLITAPP_TYPE

app_typesstring

ALLMOBILETABLETWEB

Returns object

reportstring
pin_idstring
windowobject
Show 3 child attributes
start_datestring (date)
end_datestring (date)
clampedboolean
seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
totalsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/pin-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pin-analytics?pin_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Video analytics

Pinterest: Get Video analytics

GET/accounts/{accountId}/pinterest/video-analytics

Organic 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.

Access: read

Try it with MCPAsk your agent to call pinterest-video-analytics-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social 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: 25

1–50

Returns object

reportstring
windowobject
Show 3 child attributes
start_datestring (date)
end_datestring (date)
clampedboolean
seriesarray of object
Show 2 item attributes
datestring (date)
metricsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
totalsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
top_video_totalsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber
top_video_pinsarray of object
Show 3 item attributes
rankinteger
pin_idstring
metricsobject
Show 14 child attributes
impressionsnumber
savesnumber
pin_clicksnumber
outbound_clicksnumber
clicksnumber
engagementsnumber
engagement_ratenumber
commentsnumber
likesnumber
profile_viewsnumber
follower_changenumber
viewsnumber
watch_time_secondsnumber
avg_view_duration_secondsnumber

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/video-analytics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Audience insights

Pinterest: Get Audience insights

GET/accounts/{accountId}/pinterest/audience-insights

Audience 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.

Access: read

Try it with MCPAsk your agent to call pinterest-audience-insights-get (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

audience_insight_typestringdefault: "YOUR_TOTAL_AUDIENCE"

YOUR_TOTAL_AUDIENCEYOUR_ENGAGED_AUDIENCEPINTEREST_TOTAL_AUDIENCE

ad_account_idstring

Returns object

audience_typestring

YOUR_TOTAL_AUDIENCEYOUR_ENGAGED_AUDIENCEPINTEREST_TOTAL_AUDIENCE

ad_account_idstring
totalinteger | null
size_is_upper_boundboolean | null
datestring (date) | null
agesarray of object
Show 3 item attributes
keystring
namestring | null
valuenumber

Share of audience 0..1

gendersarray of object
Show 3 item attributes
keystring
namestring | null
valuenumber

Share of audience 0..1

countriesarray of object
Show 3 item attributes
keystring
namestring | null
valuenumber

Share of audience 0..1

metrosarray of object
Show 3 item attributes
keystring
namestring | null
valuenumber

Share of audience 0..1

devicesarray of object
Show 3 item attributes
keystring
namestring | null
valuenumber

Share of audience 0..1

interestsarray of object
Show 4 item attributes
keystring
namestring | null
valuenumber
indexnumber | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/audience-insights
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/audience-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
GET/accounts/{accountId}/pinterest/trending-keywords

Top 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.

Access: read

Try it with MCPAsk your agent to call pinterest-trending-keywords-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social 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 string
gendersarray of string
agesarray of string
include_keywordsarray of string

≤ 50 items

normalize_against_groupboolean
include_demographicsboolean
limitintegerdefault: 50

1–50

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
keywordstringread-only
pct_growth_wowinteger | null
pct_growth_mominteger | null
pct_growth_yoyinteger | null
time_seriesobject | null
demographicsobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/trending-keywords
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/trending-keywords?region=US&trend_type=growing" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
GET/accounts/{accountId}/pinterest/featured-topics

Editorially 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.

Access: read

Try it with MCPAsk your agent to call pinterest-featured-topics-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

regionstringrequireddefault: "US"

USGB+IECA

intereststring

ALLANIMALSARCHITECTUREARTBEAUTYDIY_AND_CRAFTSEDUCATIONEVENT_PLANNINGFASHIONFOOD_AND_DRINKSGARDENINGHEALTHHOME_DECORPARENTINGTRAVELWEDDING

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 9 item attributes
idstringread-only
titlestringread-only
descriptionstringread-only
intereststringread-only

ALLANIMALSARCHITECTUREARTBEAUTYDIY_AND_CRAFTSEDUCATIONEVENT_PLANNINGFASHIONFOOD_AND_DRINKSGARDENINGHEALTHHOME_DECORPARENTINGTRAVELWEDDING

percent_growth_mominteger | null
related_searchesarray of string
related_interestsarray of string
pinsarray of object
time_seriesobject
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/featured-topics
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/featured-topics?region=US" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Editorial articles

Pinterest: List Editorial articles

GET/accounts/{accountId}/pinterest/editorial-articles

Pinterest 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.

Access: read

Try it with MCPAsk your agent to call pinterest-editorial-articles-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

regionstringrequireddefault: "US"

USGB+IECA

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
titlestringread-only
descriptionstringread-only
board_urlstring (uri)read-only
pins_urlarray of string (uri)
interestsarray of string
related_keywordsarray of object
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/editorial-articles
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/editorial-articles?region=US" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
GET/accounts/{accountId}/pinterest/trending-product-categories

Trending 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.

Access: read

Try it with MCPAsk your agent to call pinterest-trending-product-categories-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

regionstringrequireddefault: "US"

USGB+IECA

verticalsarray of string
agesarray of string
gendersarray of string
engagement_typestringdefault: "ENGAGEMENT"

ENGAGEMENTOUTBOUND_CLICKSAVE

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 6 item attributes
pinterest_product_category_idintegerread-only
product_categorystringread-only
verticalsarray of string
engagement_typestring

ENGAGEMENTOUTBOUND_CLICKSAVE

pct_change_mominteger
percent_relative_volumeinteger
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/trending-product-categories
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/trending-product-categories?region=US" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200
POST/accounts/{accountId}/pinterest/trending-product-categories/details

Category 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-trending-product-categories-details (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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 stringrequired

1–20 items

regionstringrequireddefault: "US"

USGB+IECA

lookback_windowintegerdefault: 365

90180365730

engagement_typestring

ENGAGEMENTOUTBOUND_CLICKSAVE

Returns object

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/trending-product-categories/details
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/trending-product-categories/details" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "product_categories": [
      "string"
    ],
    "region": "US",
    "lookback_window": 365,
    "engagement_type": "ENGAGEMENT"
  }'
Response · 200

Ad accounts

Pinterest: List Ad accounts (Business Access)

GET/accounts/{accountId}/pinterest/ad-accounts

Ad 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.

Access: read

Try it with MCPAsk your agent to call pinterest-ad-accounts-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

include_shared_accountsbooleandefault: true

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
namestringread-only
countrystring | nullread-only
currencystring | nullread-only
time_zonestring | nullread-only
ownerobject | nullread-only
Show 2 child attributes
idstring
usernamestring
permissionsarray of stringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/ad-accounts
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/ad-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Act as this profile (Ad accounts (Business Access))

POST/accounts/{accountId}/pinterest/ad-accounts/{itemId}/act-as

Returns 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-ad-accounts-act-as (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/ad-accounts/{itemId}/act-as
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/ad-accounts/ITEM_ID/act-as" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Pinterest: Stop acting as a client (Ad accounts (Business Access))

POST/accounts/{accountId}/pinterest/ad-accounts/stop-acting

Stop 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-ad-accounts-stop-acting (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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

objectstringrequired

focus_action_result

platformstringrequired
resourcestringrequired
actionstringrequired
idstring | nullrequired
resultany

The action's return value (object, array, scalar or null)

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/ad-accounts/stop-acting
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/ad-accounts/stop-acting" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
Response · 200

Businesses

Pinterest: List Businesses

GET/accounts/{accountId}/pinterest/businesses

Businesses 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.

Access: read

Try it with MCPAsk your agent to call pinterest-businesses-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 8 item attributes
idstringread-only
business_rolesarray of stringread-only
created_by_businessobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_by_userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_timeinteger | nullread-only
userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
is_shared_partnerboolean | nullread-only
assets_summaryobject | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/businesses
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/businesses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Business members

Pinterest: List Business members

GET/accounts/{accountId}/pinterest/business-members

Members 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.

Access: read

Try it with MCPAsk your agent to call pinterest-business-members-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

business_idstringrequired
business_rolesarray of string
assets_summaryboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
business_rolesarray of stringread-only
created_by_businessobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_by_userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_timeinteger | nullread-only
userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
is_shared_partnerboolean | nullread-only
assets_summaryobject | nullread-only
member_idstringread-only
business_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/business-members
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-members?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Update a Business members item

PATCH/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.

Access: write

Try it with MCPAsk your agent to call pinterest-business-members-update (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Body object

business_rolestringrequired

EMPLOYEEBIZ_ADMIN

Returns object

idstringread-only
business_rolesarray of stringread-only
created_by_businessobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_by_userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_timeinteger | nullread-only
userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
is_shared_partnerboolean | nullread-only
assets_summaryobject | nullread-only
member_idstringread-only
business_idstringread-only

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
PATCH/accounts/{accountId}/pinterest/business-members/{itemId}
curl -X PATCH "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "business_role": "EMPLOYEE"
  }'
Response · 200

Pinterest: Delete a Business members item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-business-members-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/business-members/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Business partners

Pinterest: List Business partners

GET/accounts/{accountId}/pinterest/business-partners

Partner 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.

Access: read

Try it with MCPAsk your agent to call pinterest-business-partners-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

business_idstringrequired
partner_typestring

INTERNALEXTERNAL

assets_summaryboolean

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 10 item attributes
idstringread-only
business_rolesarray of stringread-only
created_by_businessobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_by_userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
created_timeinteger | nullread-only
userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
is_shared_partnerboolean | nullread-only
assets_summaryobject | nullread-only
partner_idstringread-only
business_idstringread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/business-partners
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-partners?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Delete a Business partners item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-business-partners-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/business-partners/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-partners/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Business assets

Pinterest: List Business assets

GET/accounts/{accountId}/pinterest/business-assets

Profiles, 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.

Access: read

Try it with MCPAsk your agent to call pinterest-business-assets-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

business_idstringrequired
asset_typestringdefault: "AD_ACCOUNT"

AD_ACCOUNTPROFILEASSET_GROUPCATALOGCONSUMER

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 5 item attributes
asset_idstringread-only
asset_typestringread-only

AD_ACCOUNTPROFILEASSET_GROUPCATALOGCONSUMER

permissionsarray of stringread-only
asset_group_infoobject | null
catalog_infoobject | null
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/business-assets
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-assets?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Business invites

Pinterest: List Business invites

GET/accounts/{accountId}/pinterest/business-invites

Pending 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.

Access: read

Try it with MCPAsk your agent to call pinterest-business-invites-list (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Query parameters

cursorstring

Pagination cursor (Pinterest bookmark)

limitintegerdefault: 25

1–250

business_idstringrequired
invite_typestring

MEMBER_INVITEPARTNER_INVITEPARTNER_REQUEST

invite_statusarray of string
is_memberbooleandefault: true

Returns object

objectstringrequired

list

dataarray of objectrequired
Show 7 item attributes
idstringread-only
invite_idstringread-only
business_idstringread-only
business_rolesarray of stringread-only
userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
invite_dataobject | nullread-only
Show 4 child attributes
invite_statusstring
invite_typestring
invite_expirationinteger
sent_atinteger
is_received_inviteboolean | nullread-only
limitinteger | null
totalinteger | null
has_morebooleanrequired
next_cursorstring | nullrequired
next_page_urlstring | null
previous_page_urlstring | null

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
GET/accounts/{accountId}/pinterest/business-invites
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-invites?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200

Pinterest: Create a Business invites item

POST/accounts/{accountId}/pinterest/business-invites

Invite 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.

Access: writeIdempotency-Key

Try it with MCPAsk your agent to call pinterest-business-invites-create (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

Headers

Idempotency-Keystring

Unique 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_idstringrequired
business_rolestringrequired

EMPLOYEEBIZ_ADMINPARTNER

invite_typestringrequired

MEMBER_INVITEPARTNER_INVITEPARTNER_REQUEST

membersarray of string

≤ 50 items

partnersarray of string

≤ 50 items

Returns object

idstringread-only
invite_idstringread-only
business_idstringread-only
business_rolesarray of stringread-only
userobject | null
Show 3 child attributes
idstring | null
usernamestring | null
emailstring | null
invite_dataobject | nullread-only
Show 4 child attributes
invite_statusstring
invite_typestring
invite_expirationinteger
sent_atinteger
is_received_inviteboolean | nullread-only

Responses

  • 201Created
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
POST/accounts/{accountId}/pinterest/business-invites
curl -X POST "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-invites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "business_id": "string",
    "business_role": "EMPLOYEE",
    "invite_type": "MEMBER_INVITE",
    "members": [
      "string"
    ],
    "partners": [
      "string"
    ]
  }'
Response · 201

Pinterest: Delete a Business invites item

DELETE/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.

Access: write

Try it with MCPAsk your agent to call pinterest-business-invites-delete (toolset focus_pinterest)Set up MCP

Path parameters

accountIdstringrequired

Social account id (sa_…)

1–80 characters

itemIdstringrequired

The network's id of the item

1–512 characters

Returns object

objectstringrequired

focus_item

platformstringrequired
resourcestringrequired
idstring | nullrequired
deletedbooleanrequired
resultany

Responses

  • 200OK
  • 4XXErrors: invalid request, auth, permission, not found, conflict, plan or rate limit
  • 5XXErrors: server or upstream network error
DELETE/accounts/{accountId}/pinterest/business-invites/{itemId}
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-invites/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
Response · 200