Appearance
Select Pinterest board
Complete the Pinterest connection flow. After OAuth, use this endpoint to save the selected board and complete the account connection. Use the X-Connect-Token header if you initiated the connection via API key.
POST /v1/connect/pinterest/select-board
Complete the Pinterest connection flow. After OAuth, use this endpoint to save the selected board and complete the account connection. Use the X-Connect-Token header if you initiated the connection via API key.
Request body
Content-Type: application/json
profileId(string) required — Your Zernio profile IDboardId(string) required — The Pinterest Board ID selected by the userboardName(string) — The board name (for display purposes)tempToken(string) required — Temporary Pinterest access token from OAuthuserProfile(object) — User profile data from OAuth redirectrefreshToken(string) — Pinterest refresh token (if available)expiresIn(integer) — Token expiration time in secondsredirect_url(string) — Custom redirect URL after connection completes
Example:
json
{
"profileId": "64f0a1b2c3d4e5f6a7b8c9d0",
"boardId": "123456789012345678",
"boardName": "Marketing Ideas",
"tempToken": "pina_...",
"userProfile": {
"id": "user123",
"username": "mybrand",
"displayName": "My Brand",
"profilePicture": "https://i.pinimg.com/..."
},
"redirect_url": "https://yourapp.com/callback"
}Responses
200 — Pinterest Board connected successfully
message(string)redirect_url(string) — Redirect URL with connection params (if provided)account(object)
400 — Missing required fields
401
403 — No access to profile or profile limit exceeded
500 — Failed to save Pinterest connection