Actions42
- Ads Actions
- Campaigns Actions
- Creatives Actions
- Audiences Actions
- Pixels Actions
- Webhooks Actions
- Reports Actions
Overview
This node enables interaction with the Snapchat Ads API, specifically allowing users to create reports within their Snapchat Ad Account. The "Create Report" operation lets you submit custom report data to generate analytics or insights based on your advertising campaigns.
Common scenarios where this node is beneficial include:
- Automating the generation of performance reports for Snapchat ad campaigns.
- Integrating Snapchat reporting into broader marketing workflows.
- Scheduling regular report creation and retrieval without manual intervention.
For example, a marketing team could use this node to automatically create detailed reports on ad spend, impressions, and conversions, then feed that data into dashboards or CRM systems.
Properties
| Name | Meaning |
|---|---|
| Ad Account ID | The unique identifier of the Snapchat Ad Account where the report will be created. |
| Report Data | JSON object containing the parameters and specifications of the Snapchat report to create. This includes metrics, dimensions, date ranges, filters, and other report configuration details as defined by Snapchat's reporting API. |
Output
The node outputs a JSON object representing the response from the Snapchat API after creating the report. This typically includes details such as the report ID, status, and any metadata returned by Snapchat confirming the report creation.
If an error occurs during the process, the output JSON will contain an error field with the error message.
The node does not output binary data.
Dependencies
- Requires an API key credential for authentication with an external service referred to as "N8N Tools API" which validates subscription and API key before making Snapchat API calls.
- Requires valid Snapchat API credentials configured in n8n to access the Snapchat Ads API.
- The node uses the base URL
https://adsapi.snapchat.comfor Snapchat API requests. - The node sends additional headers including workflow and execution identifiers for tracking.
Troubleshooting
- Invalid subscription or API key: If the node throws an error indicating invalid subscription or API key, verify that the API key credential used for the external validation service is correct and active.
- Malformed Report Data: Ensure that the JSON provided in the "Report Data" property is correctly formatted and complies with Snapchat's API requirements. Invalid JSON or missing required fields can cause errors.
- Missing Ad Account ID: The Ad Account ID is required; omitting it will result in failure.
- API Rate Limits or Permissions: Snapchat API may enforce rate limits or require specific permissions. Check your Snapchat developer account settings if requests fail unexpectedly.
- Network Issues: Connectivity problems between n8n and Snapchat API or the validation service can cause timeouts or failures.