N8N Tools Snapchat icon

N8N Tools Snapchat

Interact with Snapchat API

Actions42

Overview

The node integrates with the Snapchat Ads API to manage various advertising resources, including reports. Specifically, for the Reports resource and the Download Report operation, it allows users to download a generated Snapchat report by specifying the Ad Account ID and the Report ID.

This node is beneficial in scenarios where automated workflows need to retrieve detailed advertising performance data from Snapchat for further analysis, reporting, or integration with other systems. For example, marketing teams can automate the download of campaign performance reports daily to feed into dashboards or data warehouses without manual intervention.

Properties

Name Meaning
Ad Account ID The unique identifier of the Snapchat Ad Account from which to download the report. This is required.
Report ID The unique identifier of the specific Snapchat report to download.

Output

The output JSON contains the data returned by the Snapchat API for the downloaded report. This typically includes the report content such as metrics, dimensions, and any metadata associated with the report.

  • The json field will hold the parsed report data.
  • There is no indication that this operation outputs binary data; the report is returned as structured JSON.

Dependencies

  • Requires an active subscription and a valid API key credential for the "N8N Tools API" service, which acts as a proxy or middleware to Snapchat's API.
  • Requires OAuth2 credentials configured for Snapchat API access.
  • The node makes HTTP requests to the Snapchat Ads API via the N8N Tools API endpoint (https://adsapi.snapchat.com).
  • Proper configuration of these credentials and API keys within 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.
  • Missing Required Parameters: Ensure both "Ad Account ID" and "Report ID" are provided; missing these will cause errors.
  • API Rate Limits or Permissions: Snapchat API may enforce rate limits or require specific permissions; ensure the connected account has access to the requested report.
  • Network Issues: Connectivity problems between n8n and the Snapchat API or the intermediary API may cause failures.
  • Error Messages:
    • "N8N Tools API: Invalid subscription or API key. Please check your credentials." — Check API key validity.
    • "N8N Tools API validation failed: <message>" — General failure; inspect the message for details.
    • "Unknown operation: downloadReport" — Indicates a misconfiguration; ensure the operation name matches exactly.

Links and References

Discussion