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 an enhanced 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 supports operations like retrieving ad accounts, campaigns, ad groups, ads, creating and updating campaigns, ad groups, and ads, deleting them, and fetching campaign analytics.
The Update Ad operation allows users to update details of an existing advertisement within a specified advertising account on Pinterest. This is useful for marketers and advertisers who want to programmatically manage their Pinterest ad campaigns, adjust ad settings, or optimize performance without manual intervention in the Pinterest UI.
Practical Examples
- Automatically update ad parameters based on performance metrics collected from other systems.
- Integrate Pinterest ad updates into broader marketing automation workflows.
- Bulk update multiple ads across campaigns using data from external sources.
Properties
| Name | Meaning |
|---|---|
| Ad ID | The unique identifier of the ad to be updated. Required to specify which ad to modify. |
(Note: The provided input properties JSON only includes "Ad ID" for the Update Ad operation under Advertising & Campaigns.)
Output
The node outputs an array of JSON objects representing the response from the Pinterest API after performing the requested operation. For the Update Ad operation, the output JSON contains the updated ad details as returned by the Pinterest Ads & Campaigns API.
If multiple items are processed, the output will be an array where each element corresponds to the result of processing one input item.
The node does not explicitly handle binary data output for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the "N8N Tools API" service, which acts as a proxy or middleware to the Pinterest API.
- Requires OAuth2 credentials for Pinterest API access.
- The node internally uses several API wrapper classes (e.g., AdsCampaignsApi) to communicate with Pinterest endpoints.
- Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential is correct and active.
- Authorization Errors: Ensure that the Pinterest OAuth2 credentials have sufficient permissions to update ads.
- Missing Required Parameters: The "Ad ID" must be provided; otherwise, the operation cannot proceed.
- API Rate Limits: Frequent calls may hit Pinterest API rate limits; consider adding delays or handling retries.
- Network Issues: Connectivity problems between n8n and the Pinterest API or the middleware service can cause failures.
Links and References
- Pinterest API v5 Documentation
- Pinterest Ads API Overview
- n8n Documentation - Creating Custom Nodes
- OAuth2 Authentication in n8n
If you need details about other operations or resources, feel free to ask!