Actions87
- Users Actions
- Shopping & Catalogs Actions
- Advertising & Campaigns Actions
- Advanced Analytics Actions
- Engagement Features Actions
- Business Tools Actions
- Search & Discovery Actions
- Pins Actions
- Boards Actions
Overview
The "Update Pin" operation in this Pinterest Enhanced node allows users to modify the details of an existing Pinterest pin. This includes updating the pin's title, description, link URL, associated board or board section, and note. It is useful for workflows that need to programmatically maintain or correct pin information without recreating pins from scratch.
Typical scenarios include:
- Automatically updating pin descriptions or notes based on external data changes.
- Changing the destination link of a pin when URLs are updated.
- Moving pins between boards or sections as part of content organization automation.
Example: A marketing team could use this node to update product pins with new promotional links or updated descriptions whenever their catalog changes.
Properties
| Name | Meaning |
|---|---|
| Pin ID | The unique identifier of the pin to update (required). |
| Title | New title for the pin (optional). |
| Description | New description text for the pin (optional, max length 800 characters). |
| Link | New URL link associated with the pin (optional). |
| Board ID | ID of the board where the pin should be placed (optional). |
| Board Section ID | ID of the board section within the board (optional). |
| Note | Additional note text for the pin (optional). |
Output
The node outputs JSON data representing the updated pin object returned by the Pinterest API. This typically includes all current pin properties such as id, title, description, link, board associations, and any metadata returned by the API after the update.
No binary data output is produced by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external service providing enhanced Pinterest API access.
- Requires OAuth2 authentication credentials for Pinterest API access.
- The node internally validates the API key via a dedicated validation endpoint before performing operations.
- No additional environment variables are required beyond configured credentials.
Troubleshooting
- Invalid API Key or Subscription: If the node throws an error about invalid subscription or API key, verify that the API key credential is correctly set up and active.
- Pin Not Found: Errors may occur if the provided Pin ID does not exist or is inaccessible. Confirm the Pin ID is correct and belongs to the authenticated user.
- Permission Issues: Updating pins requires appropriate permissions on the Pinterest account. Ensure the OAuth2 credentials have sufficient scopes.
- Field Validation Errors: Providing invalid values (e.g., too long descriptions) may cause API errors. Adhere to documented field limits.
- Network or API Downtime: Temporary failures can happen due to network issues or Pinterest API outages. Retrying later may resolve these.