Pinterest API v5
Official Pinterest API v5 profile for Pins and Boards. Create a Pinterest developer app, complete OAuth 2.0 authorization, request only the required pins:read, pins:write, boards:read, and boards:write scopes, and send the access token as Authorization: Bearer TOKEN. Business account access, review, media-source requirements, rate limits, and endpoint availability remain controlled by Pinterest.
Connect this API to an AI agent Browse all specs
What you can do with Pinterest API v5 via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /pins |
list_pinterest_pins | List Pins Method: GET Path: /pins IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - bookmark: Pagination bookmark - page_size: Page size |
| POST | /pins |
create_pinterest_pin | Create a Pin Method: POST Path: /pins IMPORTANT: This function has 2 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - board_id: Provider resource identifier. - media_source: media_source parameter from application/json OPTIONAL: - title: Text content. - description: description parameter from application/json - link: link parameter from application/json |
| GET | /pins/{pin-id} |
get_pinterest_pin | Read a Pin Method: GET Path: /pins/{pin-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - pin-id: Pinterest Pin ID |
| PATCH | /pins/{pin-id} |
update_pinterest_pin | Update a Pin Method: PATCH Path: /pins/{pin-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 4 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - pin-id: Pinterest Pin ID Request Body: OPTIONAL: - title: title parameter from application/json - description: description parameter from application/json - link: link parameter from application/json - board_id: Provider resource identifier. |
| DELETE | /pins/{pin-id} |
delete_pinterest_pin | Delete a Pin Method: DELETE Path: /pins/{pin-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - pin-id: Pinterest Pin ID |
| GET | /boards |
list_pinterest_boards | List Boards Method: GET Path: /boards IMPORTANT: This function has 0 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - bookmark: Pagination bookmark - page_size: Page size |
| POST | /boards |
create_pinterest_board | Create a Board Method: POST Path: /boards IMPORTANT: This function has 1 REQUIRED parameter(s) and 1 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Request Body: REQUIRED: - name: Text content. OPTIONAL: - description: description parameter from application/json |
| GET | /boards/{board-id} |
get_pinterest_board | Read a Board Method: GET Path: /boards/{board-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - board-id: Pinterest Board ID |
| PATCH | /boards/{board-id} |
update_pinterest_board | Update a Board Method: PATCH Path: /boards/{board-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - board-id: Pinterest Board ID Request Body: OPTIONAL: - name: name parameter from application/json - description: description parameter from application/json |
| DELETE | /boards/{board-id} |
delete_pinterest_board | Delete a Board Method: DELETE Path: /boards/{board-id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - board-id: Pinterest Board ID |
Usage guide
## Authentication Official Pinterest API v5 profile for Pins and Boards. Create a Pinterest developer app, complete OAuth 2.0 authorization, request only the required pins:read, pins:write, boards:read, and boards:write scopes, and send the access token as Authorization: Bearer TOKEN. Business account access, review, media-source requirements, rate limits, and endpoint availability remain controlled by Pinterest. ## Endpoint coverage This listing contains 4 documented path(s) and 10 operation(s). Review each operation's required OAuth scope or token type before use. ## Official documentation [Pinterest developer documentation](https://developers.pinterest.com/docs/api/v5/introduction/)
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “Pinterest API v5” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.