# Focus · Pinterest API

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

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## 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` · MCP tool: `pinterest-profile-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/profile" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "username": "string",
  "account_type": "PINNER",
  "business_name": "string",
  "about": "string",
  "profile_image": "https://example.com",
  "website_url": "https://example.com",
  "follower_count": 1,
  "following_count": 1,
  "pin_count": 1,
  "board_count": 1,
  "monthly_views": 1
}
```

## 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` · MCP tool: `pinterest-linked-businesses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/linked-businesses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "username": "string",
      "image_small_url": "https://example.com",
      "image_medium_url": "https://example.com",
      "image_large_url": "https://example.com",
      "image_xlarge_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-followers-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/followers" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "username": "string",
      "type": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-following-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `feed_type` (string; one of ALL, RANKED, CREATOR_ONLY, RANKED_CREATOR_ONLY)
- `explicit_following` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/following" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "username": "string",
      "type": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-following-follow`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `username` (string; required)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-following-boards-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `explicit_following` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/following-boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "PUBLIC",
      "url": "https://example.com",
      "pin_count": 1,
      "follower_count": 1,
      "collaborator_count": 1,
      "is_ads_only": false,
      "image_cover_url": "https://example.com",
      "owner_username": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "board_pins_modified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-interests-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `username` (string): Defaults to the connected account

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/interests" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "key": "string",
      "name": "string",
      "canonical_url": "https://example.com"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-websites-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/websites" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "website": "https://example.com",
      "status": "string",
      "verified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-websites-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `website` (string; required)
- `verification_method` (string; one of METATAG, FILENAME, DNSTXT)

```bash
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:

```json
{
  "website": "https://example.com",
  "status": "string",
  "verified_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `pinterest-websites-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/websites/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-websites-verification-code`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `read` · MCP tool: `pinterest-boards-list` · Zernio: `GET /v1/accounts/{accountId}/pinterest-boards`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `privacy` (string; one of ALL, PUBLIC, PROTECTED, SECRET, PUBLIC_AND_SECRET)
- `q` (string): Search boards by name

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "privacy": "PUBLIC",
      "url": "https://example.com",
      "pin_count": 1,
      "follower_count": 1,
      "collaborator_count": 1,
      "is_ads_only": false,
      "image_cover_url": "https://example.com",
      "owner_username": "string",
      "created_at": "2026-10-13T09:00:00.000Z",
      "board_pins_modified_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-boards-create` · Zernio: `POST /v1/accounts/{accountId}/pinterest-boards`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `name` (string; required; ≤ 180 characters)
- `description` (string)
- `privacy` (string; one of PUBLIC, PROTECTED, SECRET)
- `is_ads_only` (boolean)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "privacy": "PUBLIC",
  "url": "https://example.com",
  "pin_count": 1,
  "follower_count": 1,
  "collaborator_count": 1,
  "is_ads_only": false,
  "image_cover_url": "https://example.com",
  "owner_username": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "board_pins_modified_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `pinterest-boards-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "privacy": "PUBLIC",
  "url": "https://example.com",
  "pin_count": 1,
  "follower_count": 1,
  "collaborator_count": 1,
  "is_ads_only": false,
  "image_cover_url": "https://example.com",
  "owner_username": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "board_pins_modified_at": "2026-10-13T09:00:00.000Z"
}
```

## 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: `write` · MCP tool: `pinterest-boards-update` · Zernio: `PUT /v1/accounts/{accountId}/pinterest-boards`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `name` (string; ≤ 180 characters)
- `description` (string)
- `privacy` (string; one of PUBLIC, SECRET)

```bash
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:

```json
{
  "id": "string",
  "name": "string",
  "description": "string",
  "privacy": "PUBLIC",
  "url": "https://example.com",
  "pin_count": 1,
  "follower_count": 1,
  "collaborator_count": 1,
  "is_ads_only": false,
  "image_cover_url": "https://example.com",
  "owner_username": "string",
  "created_at": "2026-10-13T09:00:00.000Z",
  "board_pins_modified_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `pinterest-boards-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/boards/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-boards-set-default`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-boards-pins`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `pin_metrics` (boolean)
- `creative_types` (array of string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-board-sections-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `board_id` (string; required)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/board-sections?board_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "section_id": "string",
      "board_id": "string",
      "name": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-board-sections-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `board_id` (string; required)
- `name` (string; required; ≤ 180 characters)

```bash
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:

```json
{
  "id": "string",
  "section_id": "string",
  "board_id": "string",
  "name": "string"
}
```

## 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` · MCP tool: `pinterest-board-sections-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `name` (string; required; ≤ 180 characters)

```bash
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:

```json
{
  "id": "string",
  "section_id": "string",
  "board_id": "string",
  "name": "string"
}
```

## 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` · MCP tool: `pinterest-board-sections-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/board-sections/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-board-sections-pins`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-pins-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `q` (string): Search your Pins
- `board_id` (string)
- `board_section_id` (string)
- `pin_filter` (string; one of exclude_native, exclude_repins, has_been_promoted)
- `creative_types` (array of string)
- `include_protected_pins` (boolean)
- `pin_type` (string; one of PRIVATE)
- `domains` (array of string; ≤ 100 items)
- `pin_metrics` (boolean): Include 90-day and lifetime metrics

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "link": "https://example.com",
      "alt_text": "string",
      "board_id": "string",
      "board_section_id": "string",
      "dominant_color": "string",
      "media_type": "image",
      "image_url": "https://example.com",
      "creative_type": "REGULAR",
      "ai_disclosures": [
        "AI_MODIFIED"
      ],
      "parent_pin_id": "string",
      "is_owner": true,
      "is_standard": true,
      "is_product": true,
      "has_been_promoted": true,
      "pin_metrics": {},
      "url": "https://example.com",
      "created_at": "2026-10-13T09:00:00.000Z"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-pins-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `board_id` (string; required)
- `board_section_id` (string)
- `title` (string; ≤ 100 characters)
- `description` (string; ≤ 800 characters)
- `link` (string (uri); ≤ 2048 characters)
- `alt_text` (string; ≤ 500 characters)
- `dominant_color` (string; pattern ^#?[0-9A-Fa-f]{6}$)
- `media_ids` (array of string; ≤ 5 items): Socialit media: 1 image, 2-5 images (carousel) or 1 video (+ optional cover image)
- `image_urls` (array of string (uri); ≤ 5 items)
- `video_url` (string (uri))
- `pinterest_media_id` (string): Processed video from Video uploads
- `cover_image_url` (string (uri))
- `cover_image_key_frame_time` (integer)
- `carousel_items` (array of object; ≤ 5 items)
  - `carousel_items[].title` (string)
  - `carousel_items[].description` (string)
  - `carousel_items[].link` (string (uri))
- `pin_type` (string; one of auto, image, carousel, video, product)
- `is_affiliate_link` (boolean)
- `is_ai_generated` (boolean)
- `ai_disclosures` (array of string)
- `parent_pin_id` (string)
- `is_standard` (boolean): false = simplified (idea-style) Pin, beta

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "link": "https://example.com",
  "alt_text": "string",
  "board_id": "string",
  "board_section_id": "string",
  "dominant_color": "string",
  "media_type": "image",
  "image_url": "https://example.com",
  "creative_type": "REGULAR",
  "ai_disclosures": [
    "AI_MODIFIED"
  ],
  "parent_pin_id": "string",
  "is_owner": true,
  "is_standard": true,
  "is_product": true,
  "has_been_promoted": true,
  "pin_metrics": {},
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `pinterest-pins-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Query parameters

- `pin_metrics` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "link": "https://example.com",
  "alt_text": "string",
  "board_id": "string",
  "board_section_id": "string",
  "dominant_color": "string",
  "media_type": "image",
  "image_url": "https://example.com",
  "creative_type": "REGULAR",
  "ai_disclosures": [
    "AI_MODIFIED"
  ],
  "parent_pin_id": "string",
  "is_owner": true,
  "is_standard": true,
  "is_product": true,
  "has_been_promoted": true,
  "pin_metrics": {},
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `pinterest-pins-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `title` (string; ≤ 100 characters)
- `description` (string; ≤ 800 characters)
- `link` (string (uri); ≤ 2048 characters)
- `alt_text` (string; ≤ 500 characters)
- `board_id` (string)
- `board_section_id` (string | null)
- `carousel_slots` (array of object)
  - `carousel_slots[].title` (string)
  - `carousel_slots[].description` (string)
  - `carousel_slots[].link` (string (uri))
- `ai_disclosures` (array of string)

```bash
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:

```json
{
  "id": "string",
  "title": "string",
  "description": "string",
  "link": "https://example.com",
  "alt_text": "string",
  "board_id": "string",
  "board_section_id": "string",
  "dominant_color": "string",
  "media_type": "image",
  "image_url": "https://example.com",
  "creative_type": "REGULAR",
  "ai_disclosures": [
    "AI_MODIFIED"
  ],
  "parent_pin_id": "string",
  "is_owner": true,
  "is_standard": true,
  "is_product": true,
  "has_been_promoted": true,
  "pin_metrics": {},
  "url": "https://example.com",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## 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` · MCP tool: `pinterest-pins-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pins/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-pins-save`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `board_id` (string; required)
- `board_section_id` (string)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-pins-move`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `board_id` (string)
- `board_section_id` (string | null)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-pins-analytics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `since` (string (date))
- `until` (string (date))
- `video` (boolean)
- `split_field` (string; one of NO_SPLIT, APP_TYPE)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-pins-metrics`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-video-uploads-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-uploads" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "media_id": "string",
      "media_type": "video",
      "status": "registered",
      "upload_url": "https://example.com",
      "upload_parameters": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-video-uploads-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `media_id` (string): Socialit media id of the video
- `url` (string (uri))
- `wait` (boolean): Wait until processing finishes
- `register_only` (boolean): Return upload_url + upload_parameters for a direct upload

```bash
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:

```json
{
  "media_id": "string",
  "media_type": "video",
  "status": "registered",
  "upload_url": "https://example.com",
  "upload_parameters": {}
}
```

## 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` · MCP tool: `pinterest-video-uploads-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-uploads/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "media_id": "string",
  "media_type": "video",
  "status": "registered",
  "upload_url": "https://example.com",
  "upload_parameters": {}
}
```

## 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: `write` · MCP tool: `pinterest-video-uploads-wait`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `timeout_seconds` (integer; 1–300)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-product-tags-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `pin_id` (string; required): Hero Pin id

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/product-tags?pin_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "hero_pin_id": "string",
      "pin_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-product-tags-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `hero_pin_id` (string; required)
- `product_pin_ids` (array of string; required; 1–24 items)

```bash
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:

```json
{
  "id": "string",
  "hero_pin_id": "string",
  "pin_id": "string"
}
```

## 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` · MCP tool: `pinterest-product-tags-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/product-tags/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `pinterest-product-tags-remove-many`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Body

- `hero_pin_id` (string; required)
- `product_pin_ids` (array of string; required; 1–24 items)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-account-analytics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Start date (UTC). Max 90 days back.
- `until` (string (date)): End date (UTC). Defaults to today.
- `from_claimed_content` (string; one of OTHER, CLAIMED, BOTH)
- `pin_format` (string; one of ALL, ORGANIC_IMAGE, ORGANIC_PRODUCT, ORGANIC_VIDEO, ADS_STANDARD, ADS_PRODUCT, ADS_VIDEO, ADS_IDEA)
- `app_types` (string; one of ALL, MOBILE, TABLET, WEB)
- `content_type` (string; one of ALL, PAID, ORGANIC)
- `source` (string; one of ALL, YOUR_PINS, OTHER_PINS)
- `split_field` (string; one of NO_SPLIT, APP_TYPE, OWNED_CONTENT, SOURCE, PIN_FORMAT)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/account-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "report": "string",
  "window": {
    "start_date": "2026-10-13",
    "end_date": "2026-10-13",
    "clamped": true
  },
  "series": [
    {
      "date": "2026-10-13",
      "metrics": {
        "impressions": 1.5,
        "saves": 1.5,
        "pin_clicks": 1.5,
        "outbound_clicks": 1.5,
        "clicks": 1.5,
        "engagements": 1.5
      }
    }
  ],
  "totals": {
    "impressions": 1.5,
    "saves": 1.5,
    "pin_clicks": 1.5,
    "outbound_clicks": 1.5,
    "clicks": 1.5,
    "engagements": 1.5,
    "engagement_rate": 1.5,
    "comments": 1.5,
    "likes": 1.5,
    "profile_views": 1.5,
    "follower_change": 1.5,
    "views": 1.5,
    "watch_time_seconds": 1.5,
    "avg_view_duration_seconds": 1.5
  },
  "splits": {
    "key": {
      "series": [
        {
          "date": "2026-10-13",
          "metrics": {
            "impressions": null,
            "saves": null,
            "pin_clicks": null,
            "outbound_clicks": null,
            "clicks": null,
            "engagements": null
          }
        }
      ],
      "totals": {
        "impressions": 1.5,
        "saves": 1.5,
        "pin_clicks": 1.5,
        "outbound_clicks": 1.5,
        "clicks": 1.5,
        "engagements": 1.5
      }
    }
  }
}
```

## 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` · MCP tool: `pinterest-top-pins-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Start date (UTC). Max 90 days back.
- `until` (string (date)): End date (UTC). Defaults to today.
- `from_claimed_content` (string; one of OTHER, CLAIMED, BOTH)
- `pin_format` (string; one of ALL, ORGANIC_IMAGE, ORGANIC_PRODUCT, ORGANIC_VIDEO, ADS_STANDARD, ADS_PRODUCT, ADS_VIDEO, ADS_IDEA)
- `app_types` (string; one of ALL, MOBILE, TABLET, WEB)
- `content_type` (string; one of ALL, PAID, ORGANIC)
- `source` (string; one of ALL, YOUR_PINS, OTHER_PINS)
- `sort_by` (string; one of ENGAGEMENT, SAVE, IMPRESSION, OUTBOUND_CLICK, PIN_CLICK)
- `num_of_pins` (integer; 1–50)
- `created_in_last_n_days` (integer; one of 30)
- `include_pins` (boolean): Fetch title and image for each Pin

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/top-pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "rank": 1,
      "pin_id": "string",
      "title": "string",
      "image_url": "https://example.com",
      "url": "https://example.com",
      "impressions": 1.5,
      "saves": 1.5,
      "pin_clicks": 1.5,
      "outbound_clicks": 1.5,
      "clicks": 1.5,
      "engagements": 1.5,
      "engagement_rate": 1.5,
      "comments": 1.5,
      "likes": 1.5,
      "profile_views": 1.5,
      "follower_change": 1.5,
      "views": 1.5,
      "watch_time_seconds": 1.5,
      "avg_view_duration_seconds": 1.5,
      "raw_metrics": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-top-video-pins-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Start date (UTC). Max 90 days back.
- `until` (string (date)): End date (UTC). Defaults to today.
- `from_claimed_content` (string; one of OTHER, CLAIMED, BOTH)
- `pin_format` (string; one of ALL, ORGANIC_IMAGE, ORGANIC_PRODUCT, ORGANIC_VIDEO, ADS_STANDARD, ADS_PRODUCT, ADS_VIDEO, ADS_IDEA)
- `app_types` (string; one of ALL, MOBILE, TABLET, WEB)
- `content_type` (string; one of ALL, PAID, ORGANIC)
- `source` (string; one of ALL, YOUR_PINS, OTHER_PINS)
- `sort_by` (string; one of SAVE, IMPRESSION, OUTBOUND_CLICK, VIDEO_MRC_VIEW, VIDEO_AVG_WATCH_TIME, VIDEO_V50_WATCH_TIME, QUARTILE_95_PERCENT_VIEW, VIDEO_10S_VIEW, VIDEO_START)
- `num_of_pins` (integer; 1–50)
- `created_in_last_n_days` (integer; one of 30)
- `include_pins` (boolean): Fetch title and image for each Pin

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/top-video-pins" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "rank": 1,
      "pin_id": "string",
      "title": "string",
      "image_url": "https://example.com",
      "url": "https://example.com",
      "impressions": 1.5,
      "saves": 1.5,
      "pin_clicks": 1.5,
      "outbound_clicks": 1.5,
      "clicks": 1.5,
      "engagements": 1.5,
      "engagement_rate": 1.5,
      "comments": 1.5,
      "likes": 1.5,
      "profile_views": 1.5,
      "follower_change": 1.5,
      "views": 1.5,
      "watch_time_seconds": 1.5,
      "avg_view_duration_seconds": 1.5,
      "raw_metrics": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-pin-analytics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `pin_id` (string; required)
- `since` (string (date)): Start date (UTC). Max 90 days back.
- `until` (string (date)): End date (UTC). Defaults to today.
- `video` (boolean): Request video metrics
- `split_field` (string; one of NO_SPLIT, APP_TYPE)
- `app_types` (string; one of ALL, MOBILE, TABLET, WEB)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/pin-analytics?pin_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "report": "string",
  "pin_id": "string",
  "window": {
    "start_date": "2026-10-13",
    "end_date": "2026-10-13",
    "clamped": true
  },
  "series": [
    {
      "date": "2026-10-13",
      "metrics": {
        "impressions": 1.5,
        "saves": 1.5,
        "pin_clicks": 1.5,
        "outbound_clicks": 1.5,
        "clicks": 1.5,
        "engagements": 1.5
      }
    }
  ],
  "totals": {
    "impressions": 1.5,
    "saves": 1.5,
    "pin_clicks": 1.5,
    "outbound_clicks": 1.5,
    "clicks": 1.5,
    "engagements": 1.5,
    "engagement_rate": 1.5,
    "comments": 1.5,
    "likes": 1.5,
    "profile_views": 1.5,
    "follower_change": 1.5,
    "views": 1.5,
    "watch_time_seconds": 1.5,
    "avg_view_duration_seconds": 1.5
  }
}
```

## 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` · MCP tool: `pinterest-video-analytics-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `since` (string (date)): Start date (UTC). Max 90 days back.
- `until` (string (date)): End date (UTC). Defaults to today.
- `sort_by` (string; one of SAVE, IMPRESSION, OUTBOUND_CLICK, VIDEO_MRC_VIEW, VIDEO_AVG_WATCH_TIME, VIDEO_V50_WATCH_TIME, QUARTILE_95_PERCENT_VIEW, VIDEO_10S_VIEW, VIDEO_START)
- `num_of_pins` (integer; 1–50)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/video-analytics" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "report": "string",
  "window": {
    "start_date": "2026-10-13",
    "end_date": "2026-10-13",
    "clamped": true
  },
  "series": [
    {
      "date": "2026-10-13",
      "metrics": {
        "impressions": 1.5,
        "saves": 1.5,
        "pin_clicks": 1.5,
        "outbound_clicks": 1.5,
        "clicks": 1.5,
        "engagements": 1.5
      }
    }
  ],
  "totals": {
    "impressions": 1.5,
    "saves": 1.5,
    "pin_clicks": 1.5,
    "outbound_clicks": 1.5,
    "clicks": 1.5,
    "engagements": 1.5,
    "engagement_rate": 1.5,
    "comments": 1.5,
    "likes": 1.5,
    "profile_views": 1.5,
    "follower_change": 1.5,
    "views": 1.5,
    "watch_time_seconds": 1.5,
    "avg_view_duration_seconds": 1.5
  },
  "top_video_totals": {
    "impressions": 1.5,
    "saves": 1.5,
    "pin_clicks": 1.5,
    "outbound_clicks": 1.5,
    "clicks": 1.5,
    "engagements": 1.5,
    "engagement_rate": 1.5,
    "comments": 1.5,
    "likes": 1.5,
    "profile_views": 1.5,
    "follower_change": 1.5,
    "views": 1.5,
    "watch_time_seconds": 1.5,
    "avg_view_duration_seconds": 1.5
  },
  "top_video_pins": [
    {
      "rank": 1,
      "pin_id": "string",
      "metrics": {
        "impressions": 1.5,
        "saves": 1.5,
        "pin_clicks": 1.5,
        "outbound_clicks": 1.5,
        "clicks": 1.5,
        "engagements": 1.5
      }
    }
  ]
}
```

## 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` · MCP tool: `pinterest-audience-insights-get`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `audience_insight_type` (string; one of YOUR_TOTAL_AUDIENCE, YOUR_ENGAGED_AUDIENCE, PINTEREST_TOTAL_AUDIENCE)
- `ad_account_id` (string)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/audience-insights" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "audience_type": "YOUR_TOTAL_AUDIENCE",
  "ad_account_id": "string",
  "total": 1,
  "size_is_upper_bound": true,
  "date": "2026-10-13",
  "ages": [
    {
      "key": "string",
      "name": "string",
      "value": 1.5
    }
  ],
  "genders": [
    {
      "key": "string",
      "name": "string",
      "value": 1.5
    }
  ],
  "countries": [
    {
      "key": "string",
      "name": "string",
      "value": 1.5
    }
  ],
  "metros": [
    {
      "key": "string",
      "name": "string",
      "value": 1.5
    }
  ],
  "devices": [
    {
      "key": "string",
      "name": "string",
      "value": 1.5
    }
  ],
  "interests": [
    {
      "key": "string",
      "name": "string",
      "value": 1.5,
      "index": 1.5
    }
  ]
}
```

## Pinterest: List Trending keywords

`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` · MCP tool: `pinterest-trending-keywords-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `region` (string; required; one of US, CA, DE, FR, ES, IT, DE+AT+CH, GB+IE, IT+ES+PT+GR+MT, PL+RO+HU+SK+CZ, SE+DK+FI+NO, NL+BE+LU, …)
- `trend_type` (string; required; one of growing, monthly, yearly, seasonal)
- `interests` (array of string)
- `genders` (array of string)
- `ages` (array of string)
- `include_keywords` (array of string; ≤ 50 items)
- `normalize_against_group` (boolean)
- `include_demographics` (boolean)
- `limit` (integer; 1–50)

```bash
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:

```json
{
  "object": "list",
  "data": [
    {
      "keyword": "string",
      "pct_growth_wow": 1,
      "pct_growth_mom": 1,
      "pct_growth_yoy": 1,
      "time_series": {},
      "demographics": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Pinterest: List Featured trends

`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` · MCP tool: `pinterest-featured-topics-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `region` (string; required; one of US, GB+IE, CA)
- `interest` (string; one of ALL, ANIMALS, ARCHITECTURE, ART, BEAUTY, DIY_AND_CRAFTS, EDUCATION, EVENT_PLANNING, FASHION, FOOD_AND_DRINKS, GARDENING, HEALTH, …)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/featured-topics?region=US" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "title": "string",
      "description": "string",
      "interest": "ALL",
      "percent_growth_mom": 1,
      "related_searches": [
        "string"
      ],
      "related_interests": [
        "string"
      ],
      "pins": [
        {}
      ],
      "time_series": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-editorial-articles-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `region` (string; required; one of US, GB+IE, CA)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/editorial-articles?region=US" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "title": "string",
      "description": "string",
      "board_url": "https://example.com",
      "pins_url": [
        "https://example.com"
      ],
      "interests": [
        "string"
      ],
      "related_keywords": [
        {}
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Pinterest: List Trending shopping categories

`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` · MCP tool: `pinterest-trending-product-categories-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `region` (string; required; one of US, GB+IE, CA)
- `verticals` (array of string)
- `ages` (array of string)
- `genders` (array of string)
- `engagement_type` (string; one of ENGAGEMENT, OUTBOUND_CLICK, SAVE)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/trending-product-categories?region=US" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "pinterest_product_category_id": 1,
      "product_category": "string",
      "verticals": [
        "string"
      ],
      "engagement_type": "ENGAGEMENT",
      "pct_change_mom": 1,
      "percent_relative_volume": 1
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## Pinterest: Category details (Trending shopping categories)

`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: `write` · MCP tool: `pinterest-trending-product-categories-details`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `product_categories` (array of string; required; 1–20 items)
- `region` (string; required; one of US, GB+IE, CA)
- `lookback_window` (integer; one of 90, 180, 365, 730)
- `engagement_type` (string; one of ENGAGEMENT, OUTBOUND_CLICK, SAVE)

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-ad-accounts-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `include_shared_accounts` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/ad-accounts" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "name": "string",
      "country": "US",
      "currency": "USD",
      "time_zone": "string",
      "owner": {
        "id": "string",
        "username": "string"
      },
      "permissions": [
        "string"
      ]
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-ad-accounts-act-as`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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: `write` · MCP tool: `pinterest-ad-accounts-stop-acting`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

```bash
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:

```json
{
  "object": "focus_action_result",
  "platform": "string",
  "resource": "string",
  "action": "string",
  "id": "string",
  "result": null
}
```

## 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` · MCP tool: `pinterest-businesses-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/businesses" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "business_roles": [
        "string"
      ],
      "created_by_business": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "created_by_user": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "created_time": 1,
      "user": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "is_shared_partner": true,
      "assets_summary": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-business-members-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `business_id` (string; required)
- `business_roles` (array of string)
- `assets_summary` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-members?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "business_roles": [
        "string"
      ],
      "created_by_business": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "created_by_user": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "created_time": 1,
      "user": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "is_shared_partner": true,
      "assets_summary": {},
      "member_id": "string",
      "business_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-business-members-update`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

### Body

- `business_role` (string; required; one of EMPLOYEE, BIZ_ADMIN)

```bash
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:

```json
{
  "id": "string",
  "business_roles": [
    "string"
  ],
  "created_by_business": {
    "id": "string",
    "username": "string",
    "email": "you@example.com"
  },
  "created_by_user": {
    "id": "string",
    "username": "string",
    "email": "you@example.com"
  },
  "created_time": 1,
  "user": {
    "id": "string",
    "username": "string",
    "email": "you@example.com"
  },
  "is_shared_partner": true,
  "assets_summary": {},
  "member_id": "string",
  "business_id": "string"
}
```

## 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` · MCP tool: `pinterest-business-members-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-members/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `pinterest-business-partners-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `business_id` (string; required)
- `partner_type` (string; one of INTERNAL, EXTERNAL)
- `assets_summary` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-partners?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "business_roles": [
        "string"
      ],
      "created_by_business": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "created_by_user": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "created_time": 1,
      "user": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "is_shared_partner": true,
      "assets_summary": {},
      "partner_id": "string",
      "business_id": "string"
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-business-partners-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-partners/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```

## 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` · MCP tool: `pinterest-business-assets-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `business_id` (string; required)
- `asset_type` (string; one of AD_ACCOUNT, PROFILE, ASSET_GROUP, CATALOG, CONSUMER)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-assets?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "asset_id": "string",
      "asset_type": "AD_ACCOUNT",
      "permissions": [
        "string"
      ],
      "asset_group_info": {},
      "catalog_info": {}
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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` · MCP tool: `pinterest-business-invites-list`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Query parameters

- `cursor` (string): Pagination cursor (Pinterest bookmark)
- `limit` (integer; 1–250)
- `business_id` (string; required)
- `invite_type` (string; one of MEMBER_INVITE, PARTNER_INVITE, PARTNER_REQUEST)
- `invite_status` (array of string)
- `is_member` (boolean)

```bash
curl "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-invites?business_id=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "id": "string",
      "invite_id": "string",
      "business_id": "string",
      "business_roles": [
        "string"
      ],
      "user": {
        "id": "string",
        "username": "string",
        "email": "you@example.com"
      },
      "invite_data": {
        "invite_status": "string",
        "invite_type": "string",
        "invite_expiration": 1,
        "sent_at": 1
      },
      "is_received_invite": true
    }
  ],
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_cursor": "string",
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```

## 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: `write` · MCP tool: `pinterest-business-invites-create`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): 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.

### Body

- `business_id` (string; required)
- `business_role` (string; required; one of EMPLOYEE, BIZ_ADMIN, PARTNER)
- `invite_type` (string; required; one of MEMBER_INVITE, PARTNER_INVITE, PARTNER_REQUEST)
- `members` (array of string; ≤ 50 items)
- `partners` (array of string; ≤ 50 items)

```bash
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:

```json
{
  "id": "string",
  "invite_id": "string",
  "business_id": "string",
  "business_roles": [
    "string"
  ],
  "user": {
    "id": "string",
    "username": "string",
    "email": "you@example.com"
  },
  "invite_data": {
    "invite_status": "string",
    "invite_type": "string",
    "invite_expiration": 1,
    "sent_at": 1
  },
  "is_received_invite": true
}
```

## 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` · MCP tool: `pinterest-business-invites-delete`

### Path parameters

- `accountId` (string; required; 1–80 characters): Social account id (sa_…)
- `itemId` (string; required; 1–512 characters): The network's id of the item

```bash
curl -X DELETE "https://api.socialit.com/v1/accounts/sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd/pinterest/business-invites/ITEM_ID" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "focus_item",
  "platform": "string",
  "resource": "string",
  "id": "string",
  "deleted": true,
  "result": null
}
```


---

Source: https://socialit.com/docs/api-reference/focus-pinterest/
