---
title: "Create Pin"
method: POST
path: "/pins"
tags: ["pins"]
---

# Create Pin

`POST /pins`

Create a Pin owned by the "operation user_account".
- By default, the "operation user_account" is the token user_account.

Notes on the `POST /pins` function:

1. This function is designed to create static Pins only - it is not currently possible to use this endpoint to create video Pins or Idea Pins.
2. This function is intended solely for publishing new static content created by the user. If you are interested in saving images created by others to your Pinterest boards, sometimes called ‘curated content’, please use our <a href="https://developers.pinterest.com/docs/add-ons/save-button">Save button</a> instead. For more tips on creating fresh content for Pinterest, review our <a href="https://developers.pinterest.com/docs/solutions/content-apps">Content App Solutions Guide</a>.

## Request body

- Pin — Pin
  - `id` string
  - `created_at` string, date-time
  - `link` string, nullable
  - `title` string, nullable
  - `description` string, nullable
  - `alt_text` string, nullable
  - `board_id` string — The board to which this Pin belongs.
  - `board_section_id` string, nullable — The board section to which this Pin belongs.
  - `board_owner` BoardOwner
    - `username` string
  - `media` PinMedia — Pin media objects.
    - `media_type` string
  - `media_source` PinMediaSource — Pin media source.
    - `source_type` string, required

## Response `201`

response

- Pin — Pin
  - `id` string
  - `created_at` string, date-time
  - `link` string, nullable
  - `title` string, nullable
  - `description` string, nullable
  - `alt_text` string, nullable
  - `board_id` string — The board to which this Pin belongs.
  - `board_section_id` string, nullable — The board section to which this Pin belongs.
  - `board_owner` BoardOwner
    - `username` string
  - `media` PinMedia — Pin media objects.
    - `media_type` string
  - `media_source` PinMediaSource — Pin media source.
    - `source_type` string, required

## Other responses

- `400` — Pin is not a call-to-create response
- `403` — The Pin's image is too small, too large or is broken
- `404` — Board, section or Pin not found
- `429` — This request exceeded a rate limit. This can happen if the client exceeds one of the published rate limits or if multiple write operations are applied to an object within a short time window.
- `default` — Unexpected error

## Changes

- **2021-11-05** (v5) `8583f6373a80` — 4 breaking, 3 info
  - the `media_source` request property type changed from no type to `object`
  - the `board_owner` response's property type changed from no type to `object` for status `201`
  - the `media` response's property type changed from no type to `object` for status `201`
  - the `media_source` response's property type changed from no type to `object` for status `201`
  - …3 more

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/pins/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pinterest/apis/pinterest-rest-api/revisions/2a34d1d22a47?raw)