Update Pin - Markifact

Updates an existing pin’s title, description, destination link, or alt text, or moves it to another board or board section. Pinterest cannot change a pin’s image or video after it is published.


App	Pinterest Organic
Operation ID	`pinterest_update_pin`
Type	Action
Connection	`pinterest` (required)
Credits per run	1
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
`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.
`pin_id`	string	Yes	-	The id of the pin to update, which pinterest_list_pins and pinterest_publish_pin return. The pin’s image or video cannot be changed, only the fields below.
`title`	string	No	-	New pin title, up to 100 characters. Leave empty to keep the current one.
`description`	string	No	-	New pin description, up to 800 characters. Leave empty to keep the current one.
`alt_text`	string	No	-	New description of the image for screen readers, up to 500 characters. Leave empty to keep the current one.
`link`	string	No	-	New destination URL the pin sends people to when clicked. Leave empty to keep the current one.
`board`	string or SelectItem	No	-	Board id to move the pin to, which pinterest_list_boards returns. Leave empty to keep the pin on its current board.
`board_section`	string	No	-	Board section id to file the pin under. Set board as well, since a section id is only valid within its own board.

SelectItem

Field	Type	Required	Default	Description
`value`	string	Yes	-	The value of the selectable item.
`label`	string	Yes	-	The label of the selectable item, used for display purposes. If not provided, defaults to the value.

Output

Type: Dict Returns the pin’s id and URL along with the fields that were updated. Fields: pin_id, pin_url, board_id, title, updated Example:

{
  "pin_id": "813744226420795884",
  "pin_url": "https://www.pinterest.com/pin/813744226420795884/",
  "title": "Autumn recipes",
  "updated": [
    "title",
    "link"
  ]
}