Overview
This node integrates with the Pinterest API v5 to manage Pinterest boards and pins. Specifically, for the Board - Create operation, it allows users to create a new Pinterest board by specifying its name and an optional description.
Common scenarios where this node is beneficial include:
- Automating the creation of Pinterest boards as part of a content marketing workflow.
- Dynamically generating boards based on user input or external data sources.
- Integrating Pinterest board management into larger automation pipelines without manual intervention.
For example, a social media manager could use this node to automatically create themed boards for different campaigns or events, ensuring consistent organization on their Pinterest account.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authentication; currently supports only OAuth2 authentication. |
| Name | The name of the new Pinterest board to be created. This is a required field. |
| Description | An optional description for the new board, providing additional context or details. |
Output
The output is a JSON object representing the newly created Pinterest board as returned by the Pinterest API. It typically includes fields such as the board's unique ID, name, description, URL, and other metadata provided by Pinterest.
Example output structure (simplified):
{
"id": "1234567890",
"name": "My New Board",
"description": "Optional description here",
"url": "https://www.pinterest.com/username/my-new-board/",
...
}
No binary data is produced by this operation.
Dependencies
- Requires an OAuth2 authentication credential configured in n8n to authorize requests to the Pinterest API.
- The node uses the Pinterest API v5 endpoint
https://api.pinterest.com/v5/boardsto create boards. - Proper API permissions/scopes must be granted to the OAuth2 credential to allow board creation.
Troubleshooting
- Missing or invalid OAuth2 credentials: Ensure that the OAuth2 credential is correctly set up and authorized with the necessary scopes to create boards.
- Required fields not provided: The "Name" property is mandatory. Omitting it will cause the API request to fail.
- API rate limits or permission errors: If the Pinterest API returns errors related to rate limiting or insufficient permissions, verify your app settings and consider adding error handling or retries.
- Network issues: Connectivity problems can cause request failures; check network access and proxy settings if applicable.