API Reference
Pinterest Accounts and Boards
Connect Pinterest, list accounts/boards, and manage boards.
Overview
Pinterest endpoints handle OAuth account connection and board lifecycle operations required before publishing pins.
What You Will Learn
- OAuth start and callback flow.
- Connected account lifecycle and revoke behavior.
- Board list/create/delete flows per account.
Implementation Checklist
- Start OAuth from authenticated PinBridge sessions.
- Store account IDs and refresh boards per publish workflow.
- Use board APIs to create and clean up campaign boards when needed.
Relevant Endpoints
GET
/v1/pinterest/oauth/startGet Pinterest authorization URL.
GET
/v1/pinterest/oauth/callback?code=...&state=...Pinterest OAuth callback endpoint.
GET
/v1/pinterest/accountsList connected Pinterest accounts.
DELETE
/v1/pinterest/accounts/{account_id}Revoke a connected account.
GET
/v1/pinterest/boards?account_id=<ACCOUNT_ID>List boards for one account.
POST
/v1/pinterest/boardsCreate a board for an account.
DELETE
/v1/pinterest/boards/{board_id}?account_id=<ACCOUNT_ID>Delete or soft-delete a board depending on environment.
Example
curl "$API_BASE_URL/v1/pinterest/boards?account_id=<ACCOUNT_ID>" \
-H "Authorization: Bearer <ACCESS_TOKEN>"