Actions42
- Ads Actions
- Campaigns Actions
- Creatives Actions
- Audiences Actions
- Pixels Actions
- Webhooks Actions
- Reports Actions
Overview
The "Get Reports" operation of the "Reports" resource in this node allows users to retrieve report data from Snapchat Ads API. This operation is useful for marketers and advertisers who want to programmatically access performance reports related to their Snapchat ad campaigns. By integrating this node into an n8n workflow, users can automate the retrieval of reports for analysis, monitoring, or further processing.
Practical examples include:
- Automatically fetching daily or weekly ad performance reports.
- Integrating Snapchat report data into dashboards or BI tools.
- Triggering alerts based on specific report metrics.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | Snapchat Ad Account ID (required) |
This property specifies the Snapchat Ad Account from which to fetch reports. It is mandatory for the operation.
Output
The output of the "Get Reports" operation is a JSON object containing the report data retrieved from the Snapchat API. The exact structure depends on the Snapchat API response but typically includes details such as report IDs, names, status, creation dates, and possibly aggregated metrics.
If the operation encounters an error and "Continue On Fail" is enabled, the output will contain an error field with the error message.
No binary data output is indicated for this operation.
Dependencies
- Requires a valid API key credential for the external "N8N Tools API" service, which acts as a proxy or validation layer for Snapchat API requests.
- Requires OAuth2 credentials configured for Snapchat API access.
- The node makes HTTP requests to the Snapchat Ads API endpoint (
https://adsapi.snapchat.com) via the helper class. - The user must have appropriate permissions and subscription to use the N8N Tools API service.
Troubleshooting
- Invalid Subscription or API Key: If the node throws an error about invalid subscription or API key, verify that the API key credential for the external service is correct and active.
- Permission Errors: Ensure the Snapchat OAuth2 credentials have sufficient permissions to access reports.
- Unknown Operation Error: This indicates a misconfiguration of the operation parameter; ensure "Get Reports" is selected.
- Network Issues: Connectivity problems to the Snapchat API or the external validation API may cause failures.
- JSON Parsing Errors: When providing JSON input properties (not applicable here), ensure valid JSON format.