Scheduling to Pinterest through SkedCast's API#
SkedCast's /v1 REST API schedules image and video Pins to Pinterest the same way it does every other platform: one POST https://api.skedcast.com/v1/posts call with a content caption and a targets block naming the connected accounts.
You need a Pinterest business account, connected once through the console or through a connect link that POST /v1/clients/{id}/connect-invites creates.
The request is one contract for every connected platform. The fields that are specific to Pinterest are listed below.
Pinterest-specific fields#
| Field | Notes |
|---|---|
boardId | Required. The numeric id of the board (digits only). List boards with GET /v1/accounts/{id}/boards. A missing value returns a 422 naming the field. |
boardId as a name | For a post to one Pinterest account, the exact board name also works if exactly one board has that name. Otherwise the request returns 422 pinterest_board_unresolved. |
accountOverrides | For a post to several Pinterest accounts, give each account's board under its account id: { "<accountId>": { "boardId": "..." } }. |
Example: schedule a post to Pinterest#
json
{
"clientId": "00000000-0000-4000-8000-000000000001",
"content": "5 layout ideas for a small studio apartment.",
"mediaIds": ["00000000-0000-4000-8000-000000000003"],
"targets": { "mode": "accounts", "accountIds": ["00000000-0000-4000-8000-000000000002"] },
"schedule": { "type": "at", "scheduledAt": "2030-01-15T15:00:00Z" },
"variants": [
{ "platform": "pinterest", "overrides": { "boardId": "654321098765432109" } }
]
}Pinterest facts#
| Fact | Value |
|---|---|
| Max caption length | 800 characters |
| Media per post | 5 image or video per Pin. |
| Native platform scheduling | No. SkedCast holds the timer and publishes at the scheduled time. |
| SkedCast's default pacing | 20 / day, with at least 30 min between posts, per account. This is SkedCast's per-account pacing, not Pinterest's own published limit. See the rate limits reference. |
Published-post URL (permalink) | https://www.pinterest.com/pin/{id}/, available once the Pin is published. |
Reading status and results#
GET https://api.skedcast.com/v1/post-targets/{id} returns the Pinterest target's status (for example scheduled, on_hold, published, failed or missed). Once the post is published, externalId and permalink point at the live post (see the table above).
on_hold:holdReasonsays why (pacing, a platform limit, media still processing, your plan, or a channel that needs reconnecting) andretryAtsays when the next try is.missed: the scheduled time passed while the post waited.outcomeReasonsays why; reschedule it.failed:failureReasonsays why. When the post may already be live,outcomeReasonisdelivery_unconfirmed: check the account, because a retry is refused.requiredActionsays what you must do (reconnect_channel,change_plan,contact_support,reschedule,retryorcheck_platform), or isnullwhen nothing is needed.- Instead of polling, subscribe to the
target.publishedandtarget.failedwebhooks (one per destination;post.publishedandpost.failedreport the whole post). See the webhooks reference below. - Or connect an MCP client and ask an agent to check. See the MCP hub below.
Pinterestapischedulingrest