---
title: "Pinterest"
metaTitle: "Post to Pinterest | Octopost Docs"
description: "Pinning to Pinterest through Octopost: one image per Pin, a title from the first line, a 500-character description and your choice of board."
---

# Pinterest

> **In testing.** Pinterest is reviewing Octopost. You can connect a Pinterest account now, and until Pinterest approves the app, new Pins are visible only to you.

A Pin on Pinterest is one image with a title, a description and an optional link. Octopost handles Pinterest's sign-in, token renewal and board lookup: you just send us your content and an image.

## Content Limits

| Constraint | Limit |
|---|---|
| Images | **Exactly 1 per Pin** (required) |
| Video | Not supported yet |
| Title | First line of your post, up to **100 characters** |
| Description | The rest of your post, up to **500 characters** |
| Link | The first URL in your post becomes the Pin's link |
| Media URLs | Must be publicly accessible |

## Good to Know

- **Every Pin needs one image.** Text-only posts and posts with more than one image are refused before anything is sent, with an error that says why.
- **The first line is the title.** Put a short title on the first line and the description below it. A one-line post uses that line for both.
- **The first URL is the Pin's link.** People who tap the Pin go there.
- **Alt text comes from your image.** Send the image as `{ "url": "...", "altText": "..." }` and Octopost sends that alt text to Pinterest.
- **Pins go to one board.** Octopost uses the first board on your Pinterest account until you pick another (see below).
- **While Pinterest reviews Octopost, Pins are private to you.** They show on your own profile only. Once Pinterest approves the app you'll reconnect the account once and new Pins will be public.

## Choosing a Board

List your boards and see which one is in use:

```bash
curl https://octopost.ink/api/accounts/ACCOUNT_ID/pinterest-board \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```json
{ "boards": [{ "id": "1234", "name": "Rubber ducks" }, { "id": "5678", "name": "Workshop" }], "boardId": "1234" }
```

Pick another one:

```bash
curl -X POST https://octopost.ink/api/accounts/ACCOUNT_ID/pinterest-board \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"boardId": "5678"}'
```

Get `ACCOUNT_ID` from `GET /api/accounts` (or `list_accounts` over MCP). Every Pin after that goes to the board you picked.

## Rate Limits

Pinterest limits how many Pins an app can create per day, and the limits are lower while the app is in review. Octopost reports a clear error if Pinterest asks it to slow down, and the post can be retried later.

## Things Octopost Handles for You

You don't need to worry about any of this, but in case you're curious:

- **Pinterest OAuth.** Connecting asks for `boards:read`, `boards:write`, `pins:read`, `pins:write` and `user_accounts:read`. `boards:write` lets Octopost make an "Octopost" board when your account has none. Octopost stores the tokens encrypted.
- **Token renewal.** Pinterest sign-ins last 30 days; Octopost renews them in the background before they expire, and renews once more and retries if Pinterest ever says a sign-in is no longer valid mid-post.
- **Board lookup.** Octopost reads your boards when you connect and again if none was saved.
- **Content validation.** The one-image rule is checked before anything is sent to Pinterest.

## Example

```json
{
  "content": "Rubber ducks in every size\nOur full range, from desk ducks to bath giants. https://example.com/ducks",
  "platforms": ["pinterest"],
  "mediaUrls": [{ "url": "https://example.com/ducks.jpg", "altText": "Six rubber ducks lined up by size" }]
}
```

That's it. Octopost takes care of the rest.
