N8N Tools - Pinterest Enhanced icon

N8N Tools - Pinterest Enhanced

Comprehensive Pinterest API v5 integration for N8N workflows
Join our community

Actions87

Overview

The "Get User Boards" operation in the Users resource fetches a paginated list of boards associated with a specified Pinterest user. This node is useful when you want to retrieve all or some of the boards that a particular user has created or follows on Pinterest.

Common scenarios include:

  • Aggregating or analyzing a user's boards for marketing or content curation.
  • Displaying a user's boards in an application or dashboard.
  • Automating workflows that involve managing or monitoring user boards.

For example, you could use this node to get the first 25 boards of a user by their username or ID, then process or filter those boards further downstream in your workflow.

Properties

Name Meaning
User ID The unique identifier or username of the Pinterest user whose boards you want to retrieve.
Page Size Number of boards to return per page (pagination). Range: 1 to 250. Default is 25.
Cursor Pagination cursor token to fetch the next page of results.
Include Private Metrics Boolean flag to include private metrics data in the response (requires elevated access).
Custom Fields Comma-separated list of additional custom fields to include in the response.

Output

The output is a JSON array where each item corresponds to a board object retrieved from the Pinterest API for the specified user. Each board object contains standard board properties such as name, description, privacy status, and potentially other metadata depending on requested custom fields and permissions.

If private metrics are included, additional analytics or usage data related to the boards may be present.

No binary data is output by this operation.

Example output snippet (simplified):

[
  {
    "id": "123456789",
    "name": "Travel Inspiration",
    "description": "Boards about travel destinations",
    "privacy": "PUBLIC",
    "created_at": "2023-01-15T12:34:56Z"
  },
  {
    "id": "987654321",
    "name": "Recipes",
    "description": "Favorite cooking recipes",
    "privacy": "SECRET",
    "created_at": "2022-11-20T08:22:10Z"
  }
]

Dependencies

  • Requires an active subscription and valid API key credential for the external service providing the Pinterest API integration.
  • Requires OAuth2 authentication credentials for Pinterest API access.
  • The node uses an internal validation call to verify API key and subscription status before executing operations.
  • No additional environment variables are explicitly required beyond configured credentials.

Troubleshooting

  • Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that your API key credential is correct and active.
  • Permission Errors: Including private metrics requires elevated access; if unauthorized errors occur, check your Pinterest API permissions.
  • Pagination Issues: If you receive incomplete results, ensure you handle pagination properly using the cursor property to fetch subsequent pages.
  • User Not Found: Providing an incorrect or non-existent User ID/username will result in errors or empty results.
  • Rate Limits: Be aware of Pinterest API rate limits which may cause throttling or temporary failures.

Links and References

Discussion