> ## Documentation Index
> Fetch the complete documentation index at: https://docs.postqueen.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> PostQueen's hosted API is https://api.postqueen.ai. The public API base is https://api.postqueen.ai/public/v1 and takes the raw API key in the Authorization header, with no Bearer prefix.
> The MCP server for posting is https://api.postqueen.ai/mcp/YOUR_API_KEY (or /mcp with Authorization: Bearer YOUR_API_KEY). docs.postqueen.ai/mcp only searches these docs and cannot post.
> The API key is under Connections > API Keys in the app, and only workspace admins can see it.

# Pinterest

> What PostQueen will post to Pinterest, and the limits it checks before a post is scheduled.

export const ChannelStatus = ({status, children}) => {
  const look = ({
    available: {
      color: 'green',
      label: 'Available'
    },
    'in-review': {
      color: 'yellow',
      label: 'In review'
    },
    soon: {
      color: 'gray',
      label: 'Soon'
    }
  })[status] || ({
    color: 'gray',
    label: status
  });
  return <div className="pq-status not-prose" data-status={status}>
      <Badge color={look.color} shape="pill" size="md">{look.label}</Badge>
      {children ? <span className="pq-status-note">{children}</span> : null}
    </div>;
};

<ChannelStatus status="soon">Cannot be connected on PostQueen yet.</ChannelStatus>

PostQueen will post image Pins, multi-image Pins and video Pins to the board you choose, each with a title, a description and a destination link.

<div className="pq-visual pq-visual-card pq-tint-lilac">
  <img noZoom src="https://mintcdn.com/forceplay/CEQwaAjYodG7Gh_r/images/site/channels/pinterest.webp?fit=max&auto=format&n=CEQwaAjYodG7Gh_r&q=85&s=dcfdd75744792ef4aa4b825d21ca4587" alt="A new Pinterest post in the PostQueen composer, with the post types Pinterest takes and the time it goes out" width="1200" height="1078" data-path="images/site/channels/pinterest.webp" />
</div>

## What you can post

<CardGroup cols={2}>
  <Card title="Text" icon="type">
    A description of up to 800 characters, and an optional Pin title of up to 100.
  </Card>

  <Card title="Media" icon="image">
    Always required: one image, 2 to 5 images of the same width and height, or one MP4 video with a cover image as the second item.
  </Card>

  <Card title="Post types" icon="layers">
    Image Pin, multi-image Pin and video Pin, saved to one of your boards.
  </Card>

  <Card title="Analytics" icon="chart-line">
    7, 30 or 90 days: impressions, Pin clicks, Pin click rate, engagement and saves by day, plus impressions, Pin clicks, outbound clicks and saves for each Pin. No follower count.
  </Card>
</CardGroup>

**Not supported:** text-only Pins, comments or follow-ups, alt text, topic tags and board sections.

## Connect Pinterest

<Note>
  Pinterest is listed in **Add Channel**, but it cannot be connected on PostQueen yet. Every Pin goes to a board, so the Pinterest account needs at least one.
</Note>

## Post settings

Each Pinterest post in the composer has these settings:

* **Title**: the Pin title, up to 100 characters. Optional.
* **Link**: where the Pin sends people who click it. Optional.
* **Select board**: the board the Pin is saved to. Required. Your boards load into the list, up to 250 of them.
* **Select Pin Color**: a background color Pinterest shows while the Pin loads. Off until you turn it on.

The post text becomes the Pin description. The field names and values for the API are on [Pinterest posting settings](/public-api/providers/pinterest).

## Good to know

* Before a post is scheduled, PostQueen checks that it has 1 to 5 media items, that the images in a multi-image Pin all have the same width and height, and that a video comes with exactly one cover image.
* Video length, file size and format are Pinterest's rules, and PostQueen does not check them first. Pinterest takes video Pins of 4 seconds to 5 minutes and images of up to 20 MB.
* A video is uploaded first, and PostQueen waits up to about 30 minutes while Pinterest processes it before the Pin is created.
* Pinterest has no way to tell whether an interrupted Pin went out. PostQueen then stops and asks you to check the account instead of pinning twice.
* The numbers for each Pin cover the last 89 days, not the Pin's whole life.

## Next steps

<CardGroup cols={2}>
  <Card title="Create a post" icon="square-pen" href="/using/create-a-post">
    Write once for several channels, then schedule it, save a draft or post now.
  </Card>

  <Card title="Channels and their status" icon="layout-grid" href="/channels/overview">
    Which networks you can connect today, what each one posts, and its text limit.
  </Card>

  <Card title="Post from an AI agent" icon="bot" href="/agents/overview">
    Ask Claude, ChatGPT, Grok Bot or another agent to schedule the post for you.
  </Card>

  <Card title="A post did not go out" icon="triangle-alert" href="/troubleshooting/post-failed">
    Why a post fails and what to do about it.
  </Card>
</CardGroup>