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 "Add to Campaign" operation under the "Lead Management" resource allows users to add one or more leads to a specified campaign. This is useful for automating lead enrollment into targeted email sequences, enabling marketers to efficiently grow and manage their campaign audiences.

Practical examples include:

  • Automatically adding new contacts collected from a CRM or form submission into an ongoing email campaign.
  • Segmenting leads by adding them to different campaigns based on user behavior or attributes.
  • Bulk enrolling leads into campaigns as part of a marketing automation workflow.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign to which leads will be added.
Additional Fields Optional parameters that can modify the request; includes:
- Limit Number of results to return (used in some operations, not directly relevant here).
- Offset Number of results to skip (used in some operations, not directly relevant here).
- Status Campaign status filter with options: Active, Paused, Stopped (not directly used here).

For the "Add to Campaign" operation, the key required property is Campaign ID. The "Additional Fields" collection is available but does not affect this operation directly.

Output

The node outputs JSON data representing the response from the SmartLead API after attempting to add leads to the specified campaign. The structure typically contains a data field with details about the added leads or confirmation of the action.

If multiple input items are processed, the output is an array where each element corresponds to the result of processing one input item.

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 HTTP requests to https://server.smartlead.ai/api/v1.
  • Proper permissions on the API key are necessary to add leads to campaigns.

Troubleshooting

  • Common issues:

    • Invalid or missing Campaign ID: The API will reject requests without a valid campaign identifier.
    • Authentication errors: Ensure the API key credential is correctly set up and has sufficient permissions.
    • Network connectivity problems: Verify that the n8n instance can reach the SmartLead API endpoint.

  • Error messages:

    • Errors returned from the API will be surfaced in the node's output if "Continue On Fail" is enabled.
    • Typical error messages may include "Campaign not found", "Unauthorized", or validation errors related to lead data.

  • Resolution tips:

    • Double-check the Campaign ID value.
    • Confirm API credentials and permissions.
    • Review the API documentation for required lead data format when adding leads.

Links and References

Discussion