PostZen
Connect

List Pinterest boards for the connect flow

GET
/v1/connect/pinterest/select-board

Lists boards after Pinterest OAuth completes so the client can show a board picker. The state handle remains valid for board selection for 30 minutes from connect-flow creation. This endpoint requires a read-write API key.

Authorization

bearerAuth
AuthorizationBearer <token>

PostZen API key.

In: header

Query Parameters

state*string

State token returned by GET /v1/connect/pinterest.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/connect/pinterest/select-board?state=string"
{  "boards": [    {      "id": "123456789012345678",      "name": "Product inspiration",      "privacy": "PUBLIC"    }  ]}
{  "error": "JSON body is required"}
{  "error": "Unauthorized"}
{  "error": "API key requires read_write permission"}
{  "error": "connect_session_not_found"}
{  "error": "connect_not_completed"}
{  "error": "connect_session_expired"}
{  "error": "not_connected"}
{  "error": "rate_limited",  "retryAfter": 30}
{  "error": "Failed to create post"}
{  "error": "request_failed"}

Set default Pinterest board PUT

Verifies a Pinterest board and stores it as the account default used when a pin target omits `settings.boardId`. This endpoint requires a read-write API key.

Select Pinterest board POST

Verifies and stores the default board for the Pinterest account created by the connect session. This endpoint requires a read-write API key.