Skip to content

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 ID
  • boardId (string) required — The Pinterest Board ID selected by the user
  • boardName (string) — The board name (for display purposes)
  • tempToken (string) required — Temporary Pinterest access token from OAuth
  • userProfile (object) — User profile data from OAuth redirect
  • refreshToken (string) — Pinterest refresh token (if available)
  • expiresIn (integer) — Token expiration time in seconds
  • redirect_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