Register an app in the Pinterest Developer portal and complete OAuth 2.0 authorization to get an access token with boards:read, boards:write, pins:read, and pins:write scopes.
Create a board by POSTing to https://api.pinterest.com/v5/boards with a JSON body containing name, description, and privacy (PUBLIC or PROTECTED or SECRET).
Upload or reference media: for image pins, you can pass a media_source of type image_url with the URL, or use the media upload endpoint first for direct uploads.
Create a pin by POSTing to https://api.pinterest.com/v5/pins with board_id, title, description, link, and media_source fields.
Verify the pin by GETting https://api.pinterest.com/v5/pins/{pin_id} and checking the status field is not DRAFT.
Known gotchas
The Pinterest v5 API replaced the older v1/v3 APIs; older documentation and many third-party libraries still reference deprecated endpoints that return errors or are silently unsupported.
Image URLs must be publicly accessible and resolve to a supported image format; Pinterest fetches the image at creation time, and private or slow URLs cause pin creation to fail or produce a blank image.
Rate limits on the v5 API are enforced per access token; bulk pin creation (e.g., migrating large boards) will hit these limits quickly, and the retry-after header must be respected.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp