Actions74
- šÆ Campaign Management Actions
- š„ Lead Management Actions
- š§ Email Accounts Actions
- š Analytics & Stats Actions
- š Smart Delivery Actions
- Get Region Provider IDs
- Create Manual Placement Test
- Create Automated Placement Test
- Get Spam Test Details
- Delete Tests in Bulk
- Stop Automated Test
- List All Tests
- Get Provider Report
- Get Geo Report
- Get Sender Account Report
- Get Spam Filter Report
- Get DKIM Details
- Get SPF Details
- Get rDNS Report
- Get Sender Account List
- Get Blacklists
- Get Domain Blacklist
- Get Spam Test Email Content
- Get Email Reply Headers
- Get Schedule History
- Get IP Details
- Get Mailbox Summary
- Get Mailbox Count
- Get All Folders
- Create Folder
- Get Folder by ID
- Delete Folder
- š Webhooks Actions
- šØ Smart Senders Actions
Overview
This node integrates with the SmartLead API to retrieve detailed campaign analytics and statistics within a specified date range. Specifically, the "Campaign Stats by Date Range" operation fetches performance data for a given email marketing campaign between optional start and end dates.
Use cases include:
- Monitoring how a campaign performed over a specific period.
- Comparing campaign metrics across different time frames.
- Generating reports on campaign engagement trends.
For example, you can use this node to pull daily open rates, click-through rates, or other relevant stats for a campaign during a product launch week or a promotional event.
Properties
| Name | Meaning |
|---|---|
| Campaign ID | The unique identifier of the campaign to retrieve statistics for. |
| Start Date | (Optional) The beginning date of the analytics period in YYYY-MM-DD format. |
| End Date | (Optional) The ending date of the analytics period in YYYY-MM-DD format. |
| Additional Fields | Collection of optional parameters: ā¢ Limit: Number of results to return (default 100). ā¢ Offset: Number of results to skip (default 0). ā¢ Status: Filter campaigns by status; options are Active, Paused, or Stopped (default Active). |
Output
The node outputs JSON data containing the campaign statistics for the specified date range. The structure typically includes an array of statistical records, each representing metrics such as opens, clicks, bounces, and other engagement indicators per day or aggregated over the period.
The output is returned under the json field and can be directly used for further processing, reporting, or visualization in n8n workflows.
No binary data output is produced by this operation.
Dependencies
- Requires an active connection to the SmartLead API via an API key credential configured in n8n.
- The node makes authenticated HTTP requests to the SmartLead server at
https://server.smartlead.ai/api/v1. - No additional external dependencies are required.
Troubleshooting
- Invalid Campaign ID: If the provided campaign ID does not exist or is incorrect, the API will likely return an error. Verify the campaign ID before running the node.
- Date Format Errors: Ensure that the Start Date and End Date are in the correct
YYYY-MM-DDformat. Invalid formats may cause request failures. - API Authentication Issues: If authentication fails, check that the API key credential is correctly set up and has sufficient permissions.
- Empty Results: If no data is returned, verify that the campaign had activity during the specified date range and that the date filters are correct.
- Rate Limits: Excessive requests might trigger rate limiting from the API. Implement delays or reduce request frequency if needed.
Common error messages usually relate to invalid JSON inputs (not applicable here since inputs are simple strings/dates), missing required parameters, or HTTP errors from the API. Review the error message details for guidance.
Links and References
- SmartLead API Documentation (general reference for API endpoints and data structures)
- n8n Documentation (for configuring credentials and using HTTP Request nodes)
This summary focuses exclusively on the "Analytics & Stats" resource and the "Campaign Stats by Date Range" operation as requested.