SmartLead

Comprehensive SmartLead API integration for email marketing automation

Actions37

Overview

This node integrates with the SmartLead API to manage leads within email marketing campaigns. Specifically, the Get All by Campaign operation retrieves all leads associated with a specified campaign. This is useful for marketers and sales teams who want to fetch and analyze lead data tied to particular campaigns, enabling targeted follow-ups, performance tracking, or exporting lead lists.

Practical examples:

  • Fetching all leads from a recent email campaign to export them into a CRM.
  • Retrieving active leads from a campaign to trigger personalized outreach workflows.
  • Getting paused or stopped leads to analyze engagement drop-offs.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign from which to retrieve leads.
Additional Fields Optional parameters to refine the results:
- Limit Number of lead records to return (default 100).
- Offset Number of lead records to skip before starting to collect the result set (default 0).
- Status Filter leads by campaign status; options are Active, Paused, or Stopped (default Active).

Output

The node outputs an array of JSON objects representing leads retrieved from the specified campaign. Each object corresponds to a lead's data as returned by the SmartLead API under the /campaigns/{campaignId}/leads endpoint.

The output structure includes typical lead information such as identifiers, contact details, status, and any other metadata provided by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the SmartLead API.
  • The node makes HTTP requests to https://server.smartlead.ai/api/v1.
  • Proper configuration of the API authentication credential in n8n is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Campaign ID will cause the API request to fail.
    • Network connectivity problems can prevent successful API calls.
    • Exceeding API rate limits may result in errors or throttling.

  • Error messages:

    • Errors returned from the API (e.g., "Campaign not found") will be surfaced as node execution errors.
    • If the node is configured to continue on failure, error details will be included in the output JSON for the failed item.

  • Resolutions:

    • Verify that the Campaign ID is correct and exists in your SmartLead account.
    • Ensure the API key credential is valid and has sufficient permissions.
    • Check network connectivity and retry if transient errors occur.
    • Use pagination (Limit and Offset) to handle large datasets and avoid timeouts.

Links and References

Discussion