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 node provides integration with the Pinterest API v5 through a comprehensive set of operations grouped by resource categories such as Pins, Boards, Users, Shopping & Catalogs, Advertising & Campaigns, Analytics, Engagement Features, Business Tools, and Search & Discovery.
Specifically, for the Advertising & Campaigns resource and the Get Ad Groups operation, the node retrieves ad groups associated with a specified advertising account and campaign. This is useful for marketers and advertisers who want to programmatically access detailed information about their ad groups within Pinterest campaigns to analyze performance, manage ads, or automate reporting workflows.
Practical example:
A marketing automation workflow could use this node to fetch all ad groups under a particular campaign in an advertising account, then iterate over these ad groups to update bids, pause underperforming groups, or export data for further analysis.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the advertising account from which to retrieve ad groups. |
| Campaign ID | The unique identifier of the campaign within the advertising account to filter ad groups. |
These properties are required inputs for the "Get Ad Groups" operation under the "Advertising & Campaigns" resource.
Output
- The output is a JSON array where each item corresponds to the data returned by the Pinterest API for the requested ad groups.
- Each JSON object contains details about an ad group, such as its ID, name, status, targeting criteria, budget, and other metadata as provided by the Pinterest Ads API.
- The node does not output binary data for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that acts as a proxy or validation layer for Pinterest API calls.
- Requires OAuth2 credentials or API authentication tokens configured in n8n for Pinterest API access.
- The node internally uses multiple helper classes to interact with different Pinterest API endpoints, including one dedicated to Ads & Campaigns.
- No additional environment variables are explicitly required beyond standard n8n credential setup.
Troubleshooting
Invalid subscription or API key error:
If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correctly configured and active in your n8n instance.Missing or incorrect Ad Account ID or Campaign ID:
Ensure that the provided IDs are correct and correspond to existing entities in your Pinterest advertising account. Invalid IDs will cause the API call to fail.API rate limits or permission errors:
If you encounter rate limiting or permission denied errors, check your Pinterest developer account permissions and ensure your OAuth token has sufficient scopes.Network or connectivity issues:
Confirm that your n8n instance can reach the external API endpoints without firewall or proxy restrictions.