Platform guide · Discovery
Create Pins on a board with Pinterest API v5. We take your image URL, title, and description and post the Pin — you pick the board once.
At a glance
| API | Pinterest API v5 |
| Connection | OAuth — supply an access token |
| Formats | Image, Video |
| Character limit | 500 |
| Media | Supported — pass a public URL |
Connect Pinterest
Pinterest connects over OAuth. Complete the network’s OAuth to mint an access token, then connect Pinterest from the dashboard’s Accounts page. These are the fields it needs:
| Field | Send as | Required | Where to find it |
|---|---|---|---|
| Access tokensecret | accessToken | Required | — |
| Board id | boardId | Required | — |
Everything marked secret is sealed with AES-256-GCM before storage — see Connecting accounts.
Publish to Pinterest
Once connected, Pinterest is just another id in your platforms array. One call publishes:
curl https://postmyish.com/api/v1/posts \
-H "Authorization: Bearer $POSTMYISH_KEY" \
-H "Content-Type: application/json" \
-d '{"caption":"12 desk setup ideas for 2026","platforms":["pinterest"]}'The same request can fan out to Instagram, Facebook and more — add their ids to the array. See Publish everywhere at once.
What you can do
- Image Pins. An image URL becomes a Pin with your title and description.
- Board targeting. Pick the board once at connect time; every Pin lands there.
- Rich descriptions. Up to 500 characters of description under the Pin.
- Scheduling. Queue Pins with schedule_at for a steady cadence.
Setup & review
FAQ
Is this the official Pinterest API?
Yes — Pinterest API v5, the POST /v5/pins endpoint.
Do I need an image?
Yes — a Pin is fundamentally an image. Pass a public image URL as media and it becomes the Pin.
Which board does it post to?
The board id you set when connecting. You can reconnect to change it.
Is there a review?
Pinterest reviews apps to leave trial mode. The Pin-creation code works in trial for your own account; review lifts the caps.