ad_account_id | integer or string | No | - | Optional, for brand profiles reached through Pinterest Business Access. The id of an ad account owned by that brand profile, e.g. ‘549769672300’. When set, the operation acts on the profile that owns this ad account instead of the signed-in profile. Ad account ids and their owning profile (ownerUsername) come from pinterest_ads_select_accounts. A profile that owns no ad account cannot be reached this way. Leave empty for the signed-in profile. |
name | string | Yes | - | The board name, up to 180 characters. Ask the user for it if it is not provided. |
description | string | No | - | What the board is about, up to 500 characters. Keywords here help Pinterest surface the board in search. |
privacy | string or SelectableOption | No | PUBLIC | Who can see the board. Available options: ‘PUBLIC’ (anyone can see the board), ‘SECRET’ (only the account owner and the board’s collaborators can see it) or ‘PROTECTED’ (Pinterest’s ad only board type, kept off the public profile). Defaults to ‘PUBLIC’. |