Accounts

Create a Pinterest board

Creates a board on the user's Pinterest account without sending them off-site. Optional setAsDefault lifts the new board id into the account's default in one round-trip. Optional upsert: true returns the existing board (with existing: true) on duplicate-name instead of 409-ing.

post/v1/accounts/{id}/pinterest/boards

Request

  • Base URL: https://api.letmepost.dev
  • URL: https://api.letmepost.dev/v1/accounts/{id}/pinterest/boards
  • Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

Idempotency-Keystring
Example:post-launch-2026-05-15-001

Recommended on every write. Replays within 24 hours return the original response; conflicting bodies surface as 409 idempotency_conflict. See Idempotency.

Request body

namestring required
descriptionstring
privacy'PUBLIC' | 'PROTECTED' | 'SECRET'
setAsDefaultboolean

Lift the new board id into tokenMetadata.defaultBoardId.

upsertboolean

When true, a duplicate-name response from Pinterest resolves to a 200 with the existing board (existing: true) instead of a platform_rejected failure.

Response

Existing board returned (only when upsert: true matched).

idstring required
namestring required
privacy'PUBLIC' | 'PROTECTED' | 'SECRET' | 'null' nullable
existingboolean
defaultBoardIdstring
defaultBoardNamestring

Changes

No recorded changes to this operation across all 1 revision of this API.