Actions42
- Ads Actions
- Campaigns Actions
- Creatives Actions
- Audiences Actions
- Pixels Actions
- Webhooks Actions
- Reports Actions
Overview
This node integrates with the Snapchat Ads API to manage and retrieve advertising data. Specifically, for the Reports resource with the Get Reports operation, it fetches reports associated with a specified Snapchat Ad Account. This is useful for marketers and advertisers who want to programmatically access performance reports of their Snapchat ad campaigns.
Typical use cases include:
- Automating the retrieval of campaign performance reports for analysis.
- Integrating Snapchat ad reporting into broader marketing dashboards or workflows.
- Scheduling regular report downloads to monitor ad effectiveness over time.
For example, a user can configure this node to pull all available reports for a given Ad Account ID, then process or store that data elsewhere automatically.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the Snapchat Ad Account from which to retrieve reports. This is required to specify the scope of the reports fetched. |
Output
The node outputs JSON data representing the Snapchat reports retrieved for the specified Ad Account. The structure of the JSON depends on the Snapchat API's response for reports but generally includes details such as report IDs, names, creation dates, metrics, and other relevant report metadata.
No binary data output is indicated for this operation.
Dependencies
- Requires an active subscription and valid API key credential for the external "N8N Tools API" service, which acts as a proxy or validation layer before accessing Snapchat's API.
- Requires OAuth2 credentials configured for Snapchat API access.
- The node makes HTTP requests to
https://adsapi.snapchat.comvia the helper API. - Proper configuration of these credentials in 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 for the external validation service is correct and active.
- Permission errors (401/403): These usually mean the provided credentials lack proper permissions or are expired. Refresh or reconfigure credentials.
- Unknown operation error: Ensure the operation parameter is set exactly to "getReports" when using the Reports resource.
- JSON parsing errors: When providing JSON input properties (not applicable here for Get Reports), ensure the JSON is well-formed.
- Network issues: Confirm network connectivity to both the validation API and Snapchat API endpoints.