N8N Tools - Pinterest Enhanced icon

N8N Tools - Pinterest Enhanced

Comprehensive Pinterest API v5 integration for N8N workflows
Join our community

Actions87

Overview

The node provides integration with Pinterest's API v5 through a comprehensive set of operations grouped by resource types such as Pins, Boards, Users, Shopping & Catalogs, Advertising & Campaigns, Analytics, Engagement Features, Business Tools, and Search & Discovery. Specifically for the Advertising & Campaigns resource, it allows users to manage advertising accounts, campaigns, ad groups, and ads on Pinterest.

For the Get Campaigns operation within the Advertising & Campaigns resource, the node fetches campaign data associated with a specified advertising account. This is useful for marketers and advertisers who want to retrieve details about their active or past campaigns on Pinterest to analyze performance or automate reporting workflows.

Practical examples:

  • Automatically retrieving all campaigns from a specific ad account to generate reports.
  • Integrating Pinterest campaign data into CRM or marketing dashboards.
  • Triggering follow-up actions based on campaign status or metrics.

Properties

Name Meaning
Ad Account ID The unique identifier of the Pinterest advertising account whose campaigns you want to retrieve.

Output

The node outputs an array of JSON objects representing the campaign(s) retrieved from the specified advertising account. Each object contains detailed information about a campaign, such as its name, status, budget, targeting, and other metadata as provided by the Pinterest Ads API.

The output is structured as:

[
  {
    "json": {
      // Campaign details object returned by the Pinterest API
    },
    "itemData": {
      "item": <index_of_input_item>
    }
  }
]

There is no binary data output 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 middleware for Pinterest API calls.
  • Requires OAuth2 credentials for Pinterest API access.
  • The node internally uses helper classes to interact with different Pinterest API endpoints, including the AdsCampaignsApi class for advertising-related operations.
  • Proper configuration of these credentials in n8n is necessary before using the node.

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.
  • Authentication errors: Ensure that the Pinterest OAuth2 credentials are valid and have the required permissions to access advertising data.
  • Missing or incorrect Ad Account ID: The Ad Account ID is required; ensure it is correctly entered and corresponds to an existing Pinterest ad account.
  • API rate limits or connectivity issues: Network problems or hitting API rate limits may cause failures; retry after some time or check network connectivity.
  • Unexpected response structure: If the Pinterest API changes, the node might not parse responses correctly; updating the node or checking for updates from the provider may help.

Links and References

Discussion