N8N Tools - Pinterest Enhanced icon

N8N Tools - Pinterest Enhanced

Comprehensive Pinterest API v5 integration for N8N workflows
Join our community

Actions87

Overview

This node operation allows users to create a new advertising campaign within an advertising account on Pinterest via the Pinterest API. It is part of a comprehensive Pinterest integration that supports managing various resources such as pins, boards, users, shopping catalogs, and advertising campaigns.

Creating a campaign is essential for advertisers who want to organize their ads under specific marketing goals or themes. This operation is beneficial when automating campaign creation workflows, integrating Pinterest advertising with other marketing tools, or managing multiple campaigns programmatically.

Practical example:

  • Automatically create a new campaign named "Spring Sale 2024" in a specified ad account with the status set to "Active" whenever a new product line is launched.
  • Use this node in a workflow triggered by an external event (e.g., new product added to inventory) to streamline campaign setup without manual intervention.

Properties

Name Meaning
Ad Account ID The unique identifier of the advertising account where the campaign will be created.
Campaign Name The name assigned to the new campaign.
Campaign Status The status of the campaign; options are: Active, Paused, or Archived.

Output

The output is a JSON object representing the newly created campaign as returned by the Pinterest Ads Campaigns API. This typically includes details such as the campaign's ID, name, status, and possibly metadata about its creation.

The node does not output binary data for this operation.

Example output structure (simplified):

{
  "id": "123456789",
  "name": "Spring Sale 2024",
  "status": "ACTIVE",
  "created_at": "2024-06-01T12:00:00Z",
  "updated_at": "2024-06-01T12:00:00Z"
}

Dependencies

  • Requires an active subscription and valid API key credential for the integrated third-party service ("N8N Tools API") that acts as a proxy or middleware for Pinterest API calls.
  • Requires OAuth2 authentication credentials for Pinterest API access.
  • The node uses internal helper classes to interact with the Pinterest Ads Campaigns API.
  • Proper configuration of these credentials in n8n is necessary before using this node.

Troubleshooting

  • Invalid subscription or API key error:
    If you receive an error indicating invalid subscription or API key, verify that your API key credential is correct and active. Check your subscription status with the third-party service providing the API proxy.

  • Missing or incorrect Ad Account ID:
    Ensure the Ad Account ID provided exists and is accessible with your authenticated Pinterest account.

  • Permission errors:
    Make sure the OAuth2 credentials have sufficient permissions to create campaigns in the specified ad account.

  • API rate limits or network issues:
    If requests fail intermittently, check for rate limiting or connectivity problems.

  • NodeOperationError:
    Errors thrown during execution will provide messages describing the issue. Use these messages to adjust input parameters or credentials accordingly.

Links and References

Discussion