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 provides a comprehensive integration with the Pinterest API v5, enabling users to interact with various Pinterest resources 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 managing ad accounts, campaigns, ad groups, ads, and retrieving campaign analytics.
The Get Ad Account operation fetches detailed information about a specific advertising account on Pinterest by its ID. This is useful for marketers and advertisers who want to programmatically retrieve account details to monitor or manage their Pinterest ad accounts within automated workflows.
Practical Examples
- Automatically retrieve ad account details before launching new campaigns.
- Integrate Pinterest ad account data into reporting dashboards.
- Use ad account info to validate account status or permissions in multi-account management systems.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the Pinterest advertising account to retrieve information for. |
Output
The node outputs JSON data representing the details of the specified Pinterest advertising account. The exact structure depends on the Pinterest API response but typically includes fields such as account name, ID, status, currency, timezone, and other metadata related to the ad account.
No binary data output is produced by this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service that acts as a proxy/validation layer for Pinterest API calls.
- Requires OAuth2 credentials or API authentication tokens configured for Pinterest API access.
- The node internally uses multiple helper classes to interact with different Pinterest API endpoints, including one dedicated to Ads & Campaigns.
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 has an active subscription.
- Missing or Incorrect Ad Account ID: Ensure the "Ad Account ID" property is provided and correctly matches an existing Pinterest ad account.
- API Rate Limits or Permissions: Pinterest API may enforce rate limits or require specific permissions; ensure your credentials have sufficient access rights.
- Network or Connectivity Issues: Check network connectivity and firewall settings if requests fail unexpectedly.
Links and References
- Pinterest API v5 Documentation
- Pinterest Advertising API Guide
- n8n Documentation - Creating Custom Nodes
This summary focuses exclusively on the Advertising & Campaigns resource and the Get Ad Account operation as requested.