POpostproxy
Pinterest

Create board

Creates a board on the connected Pinterest account. The board becomes a placement of the profile right away; its id is the board_id you publish to. Pinterest rejects duplicate board names with a 422.

post/api/profiles/{profile_id}/pinterest/create_board

Request

  • Base URL
    https://api.postproxy.dev
  • URL
    https://api.postproxy.dev/api/profiles/{profile_id}/pinterest/create_board
  • Auth
    HTTP bearer

Path parameters

profile_idstring required

Profile id (must be a pinterest profile)

Query parameters

profile_group_idstring

Profile group context for the request. Optional when the API key is scoped to a profile group (that group is used automatically); with a full-access key, defaults to the first profile group in the account.

Headers

Idempotency-Keystring

Optional idempotency key (up to 255 characters; a UUID is ideal). Retrying a successful write with the same key replays the original response (with an Idempotent-Replay: true header) instead of executing again. Stored responses are kept for 24 hours; only 2xx responses are stored.

Request body

namestring required

Board name. Must be unique among the account's boards

descriptionstring

Board description

privacy'PUBLIC' | 'PROTECTED'

Board visibility

Response

The new board, as a placement

idstring nullable

Platform-specific placement ID. null for personal profile (LinkedIn).

namestring

Display name of the placement.

avatar_urlstring nullable

Stable Postproxy storage URL of the placement's picture, resized to 256x256 (Facebook Pages). null until it has been mirrored and for networks without one.

metadataobject

Extra per-placement data Postproxy stores. For Google Business this carries the location's place_id (Google Maps Place ID). {} when there's nothing extra.

Changes

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