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 Board" operation in the Pinterest Enhanced node allows users to modify an existing Pinterest board's details such as its name (title), description, and privacy settings. This operation is useful when you want to keep your Pinterest boards up-to-date with new information or change their visibility status.
Common scenarios:
- Renaming a board to better reflect its content.
- Updating the description to provide more context or keywords.
- Changing the board's privacy from public to secret or vice versa.
Practical example:
You have a board named "Summer Recipes" but want to rename it to "Summer BBQ Recipes" and make it secret so only you can see it. Using this operation, you provide the board ID, the new title, and set privacy to "Secret" to update the board accordingly.
Properties
| Name | Meaning |
|---|---|
| Board ID | The unique identifier of the board to update. |
| Title | New name/title for the board. |
| Description | Updated description text for the board (up to 800 characters). |
| Privacy | Privacy setting of the board; options are Public or Secret. |
| Include Private Metrics | Whether to include private metrics in the response (requires elevated access). |
| Custom Fields | Comma-separated list of additional custom fields to include in the response. |
Output
The output JSON contains the updated board object returned by the Pinterest API after the update operation. It typically includes:
- Board ID
- Name (updated title)
- Description (updated description)
- Privacy status
- Other metadata fields depending on requested custom fields and permissions
If private metrics are included, additional analytics data related to the board may be present.
No binary data is output by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external API service used (referred generically as "N8N Tools API").
- Requires OAuth2 authentication credentials for Pinterest API access.
- The node internally uses a Pinterest API client library to perform the update operation.
- Proper permissions/scopes must be granted to the API token to allow board updates.
Troubleshooting
- Invalid Board ID: If the provided Board ID does not exist or is incorrect, the API will return an error. Verify the Board ID before running the node.
- Insufficient Permissions: Attempting to update a board without proper authorization or scopes will result in permission errors. Ensure the OAuth2 credentials have the required access.
- Invalid Privacy Value: Only "Public" or "Secret" are accepted values for privacy. Providing other values will cause validation errors.
- API Key or Subscription Issues: Errors indicating invalid subscription or API key mean the external API credentials need verification or renewal.
- Description Length Exceeded: Descriptions longer than 800 characters will be rejected. Keep descriptions within the limit.
To resolve errors, check credentials, input parameters, and ensure the user has rights to modify the specified board.