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
This node integrates with the Pinterest API v5 via an enhanced API wrapper, providing comprehensive access to Pinterest's features within n8n workflows. Specifically, for the Shopping & Catalogs resource and the Create Product Group operation, it allows users to create a new product group inside a specified shopping catalog on Pinterest.
This is useful for e-commerce businesses or marketers who manage product catalogs on Pinterest and want to organize products into groups programmatically as part of automated workflows. For example, you can automate grouping seasonal products or promotional items into distinct product groups to better manage your Pinterest shopping catalogs.
Properties
| Name | Meaning |
|---|---|
| Catalog ID | The unique identifier of the shopping catalog in which the product group will be created. This is required to specify the target catalog. |
| Title | The name/title of the new product group to be created within the specified catalog. |
Note: The "Title" property is inferred from the code usage (this.getNodeParameter("title",e)) when creating a product group, although not explicitly listed in the provided JSON snippet.
Output
The node outputs an array of JSON objects representing the response from the Pinterest API after creating the product group. Each output item corresponds to one execution input item and contains:
json: The full JSON response from the API call that creates the product group, typically including details such as the product group's ID, name, filters (empty by default), and other metadata returned by Pinterest.itemData.item: The index of the input item that generated this output.
No binary data output is involved in this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service, which acts as a proxy/validation layer for Pinterest API calls.
- Requires Pinterest OAuth2 credentials configured in n8n to authorize API requests.
- The node uses internal helper classes wrapping Pinterest API endpoints, specifically the Shopping Catalogs API client.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that the API key credential is correctly set up and active.
- Missing Required Parameters: Ensure that the "Catalog ID" and "Title" properties are provided; otherwise, the API call will fail.
- API Rate Limits or Permissions: Pinterest API may enforce rate limits or require specific permissions/scopes for managing shopping catalogs. Check your Pinterest app settings and permissions if requests fail.
- Network or Connectivity Issues: Since the node relies on external API calls, network issues can cause failures. Verify internet connectivity and proxy/firewall settings if applicable.
Links and References
- Pinterest API v5 Documentation - Shopping Catalogs
- Pinterest Product Groups API Reference
- n8n Documentation - Creating Custom Nodes
- N8N Tools API Service (for API key management and subscription)
If you need further details on other operations or resources, feel free to ask!