Guide
Create Pins without a second publishing stack.
platform: pinterest
Publish image and video Pins with titles, destination links, boards and board sections. Read Pin and account analytics next to the rest of your channels.
Connect
Sign in with Pinterest (OAuth). Socialit refreshes tokens in the background.
Use the hosted or headless flow described in Connecting accounts. Once connected, the account appears in GET /v1/accounts?platform=pinterest.
Publish
| Post type | Limits and notes |
|---|---|
| Pins | Image or video Pins with title, link and board |
| Images | – |
| Video | – |
curl https://api.socialit.com/v1/posts \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"content": "Focus mode is live. Open one account, use everything.",
"account_ids": [
"sa_pinterest…"
],
"media_ids": [
"med_7Hk2…"
],
"scheduled_at": "2026-10-14T09:00:00.000Z",
"platform_options": {
"pinterest": {
"board_id": "brd_…",
"title": "Focus mode in 60 seconds",
"link": "https://socialit.com/"
}
}
}'Network-specific options go under platform_options.pinterest (schemas: GET /v1/posts/platform-options). Socialit validates them before publishing and returns 422 with per-field errors otherwise.
Capabilities
| Publishing | Yes |
| Direct messages | No |
| Comments | No |
| Reviews | No |
| Mentions | No |
| Analytics | Post and account metrics |
| Edit after publishing | No |
| Delete or unpublish | Yes |
| First comment | No |
| Ads | Pinterest Ads |
Focus mode
In Focus mode a Pinterest account exposes:
- Boards and board sections
- Pins with links, alt text and covers
- Pin and account analytics
- Pinterest Ads campaigns
Each resource is also available at /v1/accounts/{id}/focus/{resource}.