SmartLead icon

SmartLead

Comprehensive SmartLead API integration for email marketing automation
Join our community

Actions74

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 the list of leads targeted or engaged in a particular campaign.

Common scenarios include:

  • Exporting or syncing lead data from a specific campaign to other systems.
  • Analyzing lead engagement or status within a campaign.
  • Automating follow-up actions based on the retrieved leads.

Example: Fetching all leads from a campaign with ID 12345 to process them further in a workflow, such as sending personalized emails or updating CRM records.

Properties

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

Output

The output is a JSON array containing lead objects retrieved from the specified campaign. Each object represents a lead with its associated data fields as provided by the SmartLead API.

  • The exact structure of each lead object depends on the API response but typically includes identifiers, contact information, status, and other lead metadata.
  • 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 API endpoint at https://server.smartlead.ai/api/v1.
  • Proper permissions and valid campaign IDs are necessary to successfully retrieve lead data.

Troubleshooting

  • Invalid Campaign ID: If the campaign ID is incorrect or does not exist, the API will likely return an error or empty result. Verify the campaign ID before running the node.
  • API Authentication Errors: Ensure that the API key credential is correctly set up and has sufficient permissions.
  • JSON Parsing Errors: Not applicable for this operation since no JSON input parsing is required here.
  • Rate Limits or Network Issues: If many requests are made rapidly, the API might throttle or block requests. Implement retry logic or reduce request frequency if needed.

Links and References

Discussion