# Pinterest capabilities

Canonical URL: https://www.outstand.so/pinterest.md
Last updated: November 2026 (2026-11-22)
API value of `network`: `pinterest`

What the Outstand REST API and MCP server can do on Pinterest. "n/a" means the caller sets nothing for that feature or the MCP server does not expose it.

## Publishing

| Feature | Supported | REST | MCP | Notes |
| --- | --- | --- | --- | --- |
| Image pin | Yes | `containers[].media[] with pinterest.board_id` | `create_post: containers[].media[], pinterest.board_id` | Up to 20 MB per image. BMP, JPEG, PNG, TIFF and WEBP. |
| Multi-image (carousel) pin | Yes | `containers[].media[]` | `create_post: containers[].media[]` | Two or more images. A pin cannot mix images and video. |
| Video pin | Yes | `containers[].media[], pinterest.cover_image_url` | `create_post: containers[].media[], pinterest.cover_image_url` | The video must be first in media. MP4 or MOV, 4 seconds to 5 minutes, up to 2 GB. |
| Text-only pin | No | n/a | n/a | Every pin needs at least one image or video. |
| Board (required) | Yes | `pinterest.board_id` | `create_post: pinterest.board_id` | Required on every pin. |
| List boards | Yes | `GET /v1/pinterest/accounts/{accountId}/boards` | `list_pinterest_boards (account_id)` |  |
| Create a board | Yes | `POST /v1/pinterest/accounts/{accountId}/boards (name, description, privacy)` | n/a | Privacy is PUBLIC, PROTECTED or SECRET. It defaults to PUBLIC. |
| Title, link and alt text | Yes | `pinterest.title, pinterest.link, pinterest.alt_text` | `create_post: pinterest.title, pinterest.link, pinterest.alt_text` | Title up to 100 characters. Alt text up to 500 characters. The container content becomes the pin description, which is truncated to 800 characters. |
| Scheduling | Yes | `scheduledAt` | `create_post: scheduledAt` | Up to 30 days ahead. A later date is rejected and no post is created. |
| Delete pin from Pinterest | Yes | `DELETE /v1/posts/{id}/remote` | `delete_remote_post` | DELETE /v1/posts/{id} alone leaves the pin live. |

## Analytics

| Feature | Supported | REST | MCP | Notes |
| --- | --- | --- | --- | --- |
| Pin analytics | Yes | `GET /v1/posts/{id}/analytics` | `get_post_analytics` | Impressions, saves, pin clicks and outbound clicks over the last 90 days. |
| Account metrics | Yes | `GET /v1/social-accounts/{id}/metrics` | `get_account_metrics` | Followers, following, pin count, plus impressions, saves, pin clicks and outbound clicks for a date range. |
| Profile | Yes | `GET /v1/pinterest/accounts/{accountId}/profile` | n/a | Username, board, pin and follower counts, monthly views. |

## Engagement

| Feature | Supported | REST | MCP | Notes |
| --- | --- | --- | --- | --- |
| Comments and replies | No | n/a | n/a | Pinterest API v5 has no comments endpoint (platform limit). |
| Repin or repost | No | n/a | n/a | Not available through the Pinterest API (platform limit). |

## Limits

- Managed Keys cover Pinterest. BYOK is optional.
- With BYOK, your Pinterest app needs Standard access to publish real pins. Trial apps create sandbox pins only.
- Exceeding Pinterest rate limits returns HTTP 429.

## Not supported

- Text-only pins.
- Comments and replies.
- Reposting or repinning.
- Mixing images and video in one pin.

## Links

- Documentation: https://www.outstand.so/docs/configurations/pinterest
- Pricing: https://www.outstand.so/pricing.md
- FAQ: https://www.outstand.so/faq.md
- Search the public docs: https://www.outstand.so/ask.md?q=Pinterest%20
- All capability sheets: https://www.outstand.so/capabilities.md
