Accounts and boards API
List the connected Pinterest accounts and their boards.
Accounts are connected through the dashboard, not through the API: linking one requires the Pinterest consent screen. The API reads them.
List accounts
GET /v1/accounts| Field | Notes |
|---|---|
id | Use it as account_id when creating a pin |
username | Pinterest handle |
status | active or disconnected |
last_published_at | Last publication, used by the pacing |
pacing_seconds | Minimum delay between two pins on this account |
A disconnected account refuses new pins with 409 and
account_disconnected. It happens when Pinterest revokes the tokens — the user
changed their password, or removed the app. Reconnect it from the dashboard;
the account keeps the same id, so your stored references stay valid.
Pincast also sends an account.disconnected webhook when this happens, so you
do not have to discover it on the next failed pin.
List the boards of an account
GET /v1/accounts/{id}/boards{
"data": [
{ "id": "602778800066682538", "name": "Products", "privacy": "PUBLIC" }
]
}The id here is the Pinterest board id — that is what you pass as board_id.
Boards are synchronised when the account is connected. A board created on Pinterest afterwards appears once the account is refreshed from the dashboard.
An unknown account answers 404 with not_found, whether it does not exist or
belongs to another organization.