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. |
board | string or SelectItem | Yes | - | The board to update. Accepts a board id, which pinterest_list_boards returns. Ask the user which board if it is not provided. |
name | string | No | - | New board name, up to 180 characters. Leave empty to keep the current one. |
description | string | No | - | New board description, up to 500 characters. Leave empty to keep the current one. |
privacy | string or SelectableOption | No | - | New privacy for 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). Leave empty to keep the current one. |