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 "Get Boards" operation of the Pinterest Enhanced node retrieves a list of Pinterest boards accessible to the authenticated user. It supports pagination and can include additional private metrics or custom fields if required. This operation is useful for workflows that need to display, analyze, or process multiple boards from a Pinterest account, such as generating reports, syncing board data with other systems, or automating content management.
Practical examples:
- Fetching all boards to display in a dashboard.
- Automating backup of board metadata.
- Analyzing board engagement by including private metrics.
- Integrating Pinterest boards with CRM or marketing tools.
Properties
| Name | Meaning |
|---|---|
| Page Size | Number of items (boards) to retrieve per page. Range: 1 to 250. Default is 25. |
| Cursor | Pagination cursor string to fetch the next page of results. |
| Include Private Metrics | Boolean flag to include private metrics in the response (requires elevated access). |
| Custom Fields | Comma-separated list of custom fields to include in the response for each board. |
Output
The output is an array of JSON objects representing Pinterest boards. Each object contains board details as returned by the Pinterest API, potentially including:
- Board identifiers and names.
- Descriptions.
- Privacy settings.
- Additional metrics if requested.
- Any custom fields specified.
The exact structure depends on the Pinterest API response and the selected fields.
No binary data output is produced by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external N8N Tools API service.
- Requires OAuth2 authentication credentials for Pinterest API access.
- The node internally uses helper classes to interact with Pinterest's API endpoints.
- Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Invalid subscription or API key error: If you receive errors about invalid subscription or API key, verify that your API key credential is correct and active.
- Permission errors when including private metrics: Including private metrics requires elevated access; ensure your Pinterest account has the necessary permissions.
- Pagination issues: If you do not handle the cursor properly, you might miss pages or get repeated data. Use the cursor value returned in the response to paginate correctly.
- Empty or incomplete data: Check that the requested custom fields are valid and supported by the Pinterest API.
- Network or API downtime: Temporary failures may occur due to network issues or Pinterest API outages; retry after some time.