N8N Tools Snapchat

Overview

This node integrates with the Snapchat Ads API to manage and retrieve data related to Snapchat advertising resources. It supports multiple resource types such as Ads, Campaigns, Creatives, Audiences, Pixels, Webhooks, and Reports. For each resource, it provides various operations like creating, updating, deleting, fetching details, and retrieving statistics.

For the Ads resource with the Default operation (which maps to several specific operations), the node allows you to:

• Retrieve a list of ads or a single ad by ID.
• Create new ads with specified data.
• Update existing ads.
• Delete ads.
• Get performance statistics for ads.

This node is beneficial in scenarios where you want to automate Snapchat ad management workflows, synchronize ad data with other systems, or generate reports programmatically without manual intervention.

Practical Examples

• Automatically create new Snapchat ads based on leads collected from a CRM.
• Periodically fetch ad performance stats to update dashboards.
• Bulk update ad properties based on external campaign changes.
• Delete outdated ads as part of cleanup automation.

Properties

The property Ad Account ID is required and must be provided to specify the context for all ad-related operations.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains the result of the requested operation on the Snapchat Ads API.

• The json field includes the response data from the Snapchat API for the given operation, such as ad details, lists of ads, confirmation of creation/update/deletion, or statistics.
• If an error occurs and "Continue On Fail" is enabled, the output will contain an error field describing the issue for that particular item.

No binary data output is produced by this node.

Dependencies

• Requires valid credentials for two APIs:
  • An API key credential for a validation service ("N8N Tools API") used to verify subscription and API key validity before making Snapchat API calls.
  • OAuth2 credentials for authenticating requests to the Snapchat Ads API.
• The node uses the base URL https://adsapi.snapchat.com for Snapchat API requests.
• Proper configuration of these credentials within n8n is necessary for successful execution.

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 correct and active. This error arises during the initial validation request before any Snapchat API call.

• Unknown Operation Error:
  If an unsupported operation name is provided, the node will throw an "Unknown operation" error. Ensure the operation parameter matches one of the supported operations for the Ads resource:
  getAds, getAd, createAd, updateAd, deleteAd, getAdStats.

• JSON Parsing Errors:
  Operations that require JSON input data (e.g., createAd, updateAd) expect valid JSON strings. Invalid JSON will cause parsing errors. Validate JSON syntax before running the node.

• API Request Failures:
  Network issues, expired OAuth tokens, or insufficient permissions can cause API request failures. Check credentials, network connectivity, and Snapchat account permissions.

Links and References

• Snapchat Marketing API Documentation
• n8n Documentation on Credentials
• n8n Node Development Guide