# Pinterest API guide

> Publish Pins with a title, description, destination link and board. Platform key: pinterest.

**Source:** https://postprism.app/docs/platforms/pinterest  
**Updated:** 2026-10-10

---

|   |   |
| --- | --- |
| Platform key | `pinterest` |
| Text limit | 500 characters (description); 100 (title) |
| Media | Required: one image. |

## Things to know

- `content` becomes the Pin description. Without `settings.title`, the first 100 characters of the text are used.
- Without `boardId`, the Pin goes to your default board, or your first board if none is set.

## Settings

Optional Pinterest options go in `platform_content.pinterest.settings`. Invalid values are rejected when you create or update the post, with a message naming the field.

| Field | Type | Description |
| --- | --- | --- |
| `boardId` | string | The Pinterest board to pin to. |
| `title` | string, up to 100 characters | The Pin title. |
| `link` | http(s) URL | Where the Pin sends people. |

**platform_content.pinterest**

```
"pinterest": {
  "content": "Five cosy autumn drinks you can make at home.",
  "settings": { "title": "Autumn coffee recipes", "link": "https://example.com/autumn-recipes" }
}
```

## Example

**POST /api/v1/posts**

```
{
  "base_content": "Our autumn menu is here.",
  "platforms": ["pinterest"],
  "platform_content": {
    "pinterest": {
      "content": "Our autumn menu is here. Which drink first?"
    }
  },
  "scheduled_at": "2026-10-16T09:30:00Z"
}
```

Other platforms: [LinkedIn](https://postprism.app/docs/platforms/linkedin), [X (Twitter)](https://postprism.app/docs/platforms/twitter), [TikTok](https://postprism.app/docs/platforms/tiktok), [YouTube](https://postprism.app/docs/platforms/youtube), [Bluesky](https://postprism.app/docs/platforms/bluesky). Writing limits for every network are in our [character limit](https://postprism.app/glossary/character-limit) reference, and the [Pinterest scheduler](https://postprism.app/platforms/pinterest-scheduler) page covers scheduling from the app.