N8N Tools Snapchat

Overview

The node "N8N Tools Snapchat" enables interaction with the Snapchat Ads API, specifically allowing users to manage various Snapchat advertising resources such as ads, campaigns, creatives, audiences, pixels, webhooks, and reports.

For the Reports resource with the Get Report operation, this node fetches detailed information about a specific Snapchat report identified by its Report ID within a given Ad Account. This is useful for retrieving analytics or performance data that Snapchat generates for ad campaigns.

Common scenarios:

• Retrieving a specific report's details to analyze campaign performance.
• Automating report fetching to integrate Snapchat ad data into dashboards or other systems.
• Using the report data in workflows for further processing or decision-making.

Practical example:
A marketing team wants to automatically pull the latest Snapchat report for a particular ad account every day to update their internal reporting system. They configure this node with the Ad Account ID and Report ID to fetch the report data seamlessly.

Properties

Output

The node outputs JSON data representing the Snapchat report details retrieved via the API. The exact structure depends on the Snapchat API response for the report but typically includes metrics, dimensions, and metadata related to the report.

• The output is an array of items, each containing a json field with the report data.
• No binary data output is indicated for this operation.

Example output snippet (conceptual):

{
  "reportId": "123456789",
  "status": "COMPLETED",
  "metrics": { ... },
  "dimensions": { ... },
  "timeRange": { ... }
}

Dependencies

• Requires valid credentials for the external API service managing Snapchat interactions, including:
  • An API key credential for the "N8N Tools API" service used for subscription validation.
  • OAuth2 credentials for authenticating with the Snapchat Ads API.
• The node performs a subscription validation call to the external API before executing the Snapchat API request.
• Network access to https://adsapi.snapchat.com is required.

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 correctly configured and active.

• Unknown operation error:
  This can occur if an unsupported operation name is provided. Ensure the operation is set to "Get Report" when working with the Reports resource.

• Missing required parameters:
  Both "Ad Account ID" and "Report ID" are required. Missing these will cause errors.

• API rate limits or network issues:
  Network failures or Snapchat API rate limiting may cause errors. Implement retry logic or check API usage quotas.

Links and References

• Snapchat Marketing API Documentation
• N8N Documentation on Creating Custom Nodes
• OAuth2 Authentication Guide