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 enhanced integration with the Pinterest 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 and the Create Ad Group operation, the node allows users to create an advertising ad group within a specified campaign under a given advertising account. This is useful for marketers and advertisers who want to programmatically manage their Pinterest ad campaigns, segmenting ads into groups for better targeting and organization.
Practical examples include:
- Automating the creation of ad groups when launching new marketing campaigns.
- Integrating Pinterest ad management into broader marketing workflows.
- Dynamically adjusting ad groups based on external triggers or data sources.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the advertising account under which the ad group will be created. |
| Campaign ID | The unique identifier of the campaign in which the ad group will be created. |
These properties are required inputs to specify where the new ad group should be created.
Output
The output JSON contains the response from the Pinterest Ads Campaigns API after creating the ad group. It typically includes details about the newly created ad group such as its ID, name, status, and other metadata returned by the API.
If the operation fails and "Continue On Fail" is enabled, the output will contain an error message describing the failure for that particular item.
The node does not explicitly handle binary data for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the "N8N Tools API" service.
- Requires OAuth2 credentials for Pinterest API access.
- The node internally uses a helper class (
AdsCampaignsApi) to interact with the Pinterest Ads Campaigns endpoints. - Proper configuration of these credentials in n8n is necessary for successful execution.
Troubleshooting
- Invalid Subscription or API Key: If the API key or subscription is invalid, the node throws an error indicating invalid credentials. Verify your API key and subscription status.
- Missing Required Parameters: Ensure that both "Ad Account ID" and "Campaign ID" are provided and correctly formatted.
- API Rate Limits or Permissions: Pinterest API may enforce rate limits or require specific permissions; ensure your credentials have sufficient access.
- Network Issues: Connectivity problems can cause request failures; check network connectivity and proxy settings if applicable.
- Unexpected API Errors: The node surfaces errors from the Pinterest API; review the error messages for guidance on resolving issues.
Links and References
This summary focuses on the "Advertising & Campaigns" resource and the "Create Ad Group" operation as requested, based on static analysis of the provided source code and property definitions.