Skip to content

Pinterest Scheduling API

Queue Pins for later on any board, each under the key that scheduled it.

  • Schedule pin posts
  • Exact times in ISO 8601
  • Reschedule or cancel until it goes out
  • Same limits, log and webhooks as posting now
post.tsnode
const pk = new Postkey(process.env.POSTKEY_KEY);

await pk.posts.create({
  accounts: [
    "acc_pin_987"
  ],
  content: "A small-space desk setup that actually works",
  media: [
    {
      type: "image",
      url: "https://cdn.example.com/desk.jpg"
    }
  ],
  pinterest: {
    boardId: "board_5521",
    title: "Small-space desk setup",
    link: "https://example.com/desk-setup",
    altText: "Wooden desk with a monitor arm in a narrow room"
  },
  scheduledFor: "2026-12-01T09:00:00Z"
});
  • Pinterestqueued

Queued for Dec 1, 09:00 UTC · key customer_42

Schedule your first Pinterest post

  1. 1

    Connect Pinterest

    Your customer signs in through Pinterest's own login. You get an account ID, never a password.

  2. 2

    Make a key

    Create a key for that customer or agent, scoped to their accounts, with the caps you choose.

  3. 3

    Schedule

    Add scheduledFor to the same request. It goes to Pinterest at that time, and a webhook tells you how it went.

Every Pinterest format, one endpoint

Pick a format to see the exact request with a publish time and what comes back. Options that only make sense on Pinterest sit under "pinterest".

An image Pin on a board, linking back to your page.

RequestREST
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6  "accounts": [7    "acc_pin_987"8  ],9  "content": "A small-space desk setup that actually works",10  "media": [11    {12      "type": "image",13      "url": "https://cdn.example.com/desk.jpg"14    }15  ],16  "pinterest": {17    "boardId": "board_5521",18    "title": "Small-space desk setup",19    "link": "https://example.com/desk-setup",20    "altText": "Wooden desk with a monitor arm in a narrow room"21  },22  "scheduledFor": "2026-12-01T09:00:00Z"23}
Response

202 · scheduled

Queued under customer_42. It goes to Pinterest at the time you set.

{
  "id": "post_3k9d2",
  "status": "scheduled",
  "scheduledFor": "2026-12-01T09:00:00Z",
  "results": [
    {
      "account": "acc_pin_987",
      "platform": "pinterest",
      "status": "queued"
    }
  ]
}

Everything you need for Pinterest scheduling

  • Checked against Pinterest's rules

    Before anything is sent, Postkey checks it against Pinterest's published limits:

    Title
    Up to 100 characterssource
    Description
    Up to 800 characterssource
    Board
    Every Pin is saved to a boardsource
  • One extra field

    Every Pinterest format you can post now can be scheduled with scheduledFor. Nothing else changes.

  • Move or cancel

    Change the time or cancel the post with one call before it goes out.

  • Checked when queued

    Text and media are checked against Pinterest's rules when you schedule, so problems show up now.

  • Board per Pin

    Every Pin lands on a board. Pass the board ID and Postkey checks the account can save to it.

  • Links that send traffic

    Each Pin can link to a page. That's most of why people post to Pinterest from an app.

Also for Pinterest

PostingPinterest Posting APICreate Pins on any board with a title, description, link and alt text, straight from your app.See the page

Keys & control

Every Pinterest post has an owner

Each customer or agent posts to Pinterest through its own key: only its accounts, its own caps, its own log, and an off switch that touches nothing else.

Works with your stack

  • Your code

    Node and Python SDKs with the same calls, or plain REST from anything that speaks HTTP.

    • Node
    • Python
    • {}REST
    Read the docs
  • No-code tools

    Call the REST API from an HTTP step in n8n, Make or Zapier. Give each workflow its own key.

    • n8n
    • Make
    • Zapier
    Postkey with n8n
  • AI agents & MCP

    The MCP server lets Claude, Cursor and other agent tools post through their own key, with caps they can't change.

    • MCP server
    About the MCP server

Pinterest scheduling questions

Something not here? Email hello@postkey.dev.

What can I post to Pinterest?

Image Pins with a title, description, destination link and alt text, saved to a board you choose.

Do I need a board ID?

Yes. Pinterest saves every Pin to a board. Postkey lists the boards for a connected account so you can pick one.

Can a Pin link to my site?

Yes. Set link and the Pin sends people to that page.

Are title and description checked?

Yes, against Pinterest's published limits listed above, before the Pin is sent.

Can I post to Pinterest and Instagram together?

Yes. List both account IDs in one request. Each gets its own result.

How do I schedule a Pinterest post?

Send the normal post request with scheduledFor in ISO 8601 (UTC or with an offset). You can cancel or move it until it goes out.

Schedule to Pinterest with a key per customer.

Get a key, connect an account, send the request above.