
Create pins, manage boards and sections, save content, and view analytics.
Authentication: oauth
Tools
• Get User Account
Get the authenticated user's Pinterest account information.
• List Boards
List all boards owned by the authenticated user.
• Create Board
Create a new Pinterest board.
• Get Board
Get details of a specific board.
• Update Board
Update a Pinterest board.
• Delete Board
Delete a Pinterest board.
• Get Board Pins
Get all pins on a specific board.
• List Board Sections
List all sections of a board.
• Create Board Section
Create a new section in a board.
• Delete Board Section
Delete a board section.
• List Pins
List all pins created by the authenticated user.
• Create Pin
Create a pin (POST /pins): one image by URL, a carousel of 2–5 images, or a video uploaded first with upload_video_from_url (mediaId). Title up to 100 characters, description and alt text up to 500.
• Get Pin
Get details of a specific pin.
• Update Pin
Update a pin.
• Delete Pin
Delete a pin.
• Save Pin
Save an existing pin to one of your boards (POST /pins/{pin_id}/save).
• Upload Video From Url
Upload a video for a pin: registers the upload (POST /media), sends the file, and returns the media_id. Poll get_media_status until it is "succeeded", then pass mediaId to create_pin. MP4 or MOV, up to 2 GB / 15 minutes on Pinterest (512 MB here).
• Get Media Status
Processing status of an uploaded video (GET /media/{media_id}): registered, processing, succeeded or failed.
• Get Pin Analytics
Get analytics for a specific pin.
• Get User Analytics
Get analytics for the authenticated user account.
• Search Pins
Search for pins by keyword.
• Search Boards
Search for boards by keyword.
Need help? Contact our support team