Pinning to Pinterest through Octopost: one image per Pin, a title from the first line, a 500-character description and your choice of board.
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:
curl https://octopost.ink/api/accounts/ACCOUNT_ID/pinterest-board \
-H "Authorization: Bearer YOUR_API_KEY"{ "boards": [{ "id": "1234", "name": "Rubber ducks" }, { "id": "5678", "name": "Workshop" }], "boardId": "1234" }Pick another one:
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:writeanduser_accounts:read.boards:writelets 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#
{
"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.