SmartLead

Comprehensive SmartLead API integration for email marketing automation

Actions74

Overview

The "Get Geo Report" operation in the Smart Delivery resource of this node fetches geographic-based email deliverability reports from the SmartLead platform. This report provides insights into how emails perform across different geographic regions, helping users understand regional variations in email placement and spam filtering.

This operation is useful for email marketers and deliverability specialists who want to analyze the effectiveness of their campaigns or tests by location. For example, a user can identify if emails are being marked as spam more frequently in certain countries or regions, enabling targeted improvements in content, sender reputation, or infrastructure.

Practical examples:

Analyzing geo-specific spam filter rates to optimize email content per region.
Monitoring delivery success in key markets to ensure compliance with local regulations.
Comparing performance of different sending domains or IPs geographically.

Properties

Name	Meaning
Test Filter Data	JSON object specifying filter and pagination options for the geo report query. Common fields include: - `limit`: Number of results to return (e.g., 10) - `offset`: Number of results to skip (e.g., 0) - Optional date filters like `date_from` and `date_to` to restrict report data by date range

Example of Test Filter Data property value:

{
  "limit": 10,
  "offset": 0,
  "date_from": "2024-01-01",
  "date_to": "2024-01-31"
}

Output

The output is a JSON array containing the geo report data returned by the SmartLead API. Each item in the array represents statistics or metrics related to email deliverability segmented by geographic region.

The exact structure depends on the API response but typically includes fields such as:

Region or country identifiers
Counts of delivered, bounced, or spam-marked emails
Other relevant metrics for email placement analysis

No binary data output is involved in this operation.

Dependencies

Requires an active connection to the SmartLead API via an API key credential configured in n8n.
The node uses the SmartLead API endpoint at https://smartdelivery.smartlead.ai/api/v1/reports/geo.
Proper permissions on the API key to access reporting endpoints are necessary.

Troubleshooting

Invalid JSON in Test Filter Data: If the JSON provided in the "Test Filter Data" property is malformed, the node will throw an error indicating invalid JSON. Ensure the JSON syntax is correct before running.
API Authentication Errors: If the API key is missing, expired, or lacks required scopes, authentication errors will occur. Verify the API key configuration in n8n credentials.
Empty or Unexpected Response: If no data matches the filter criteria (e.g., date range too narrow), the output may be empty. Adjust filters accordingly.
Rate Limits or API Downtime: The SmartLead API may enforce rate limits or experience downtime. Retry later or check API status if requests fail unexpectedly.

Links and References

SmartLead API Documentation (general reference for API endpoints and data structures)
Smart Delivery Geo Reports (specific section on geo report usage and parameters)

This summary focuses exclusively on the "Get Geo Report" operation within the "Smart Delivery" resource based on static code analysis of the node's execute method and provided property definitions.

SmartLeadInstall