SmartLead icon

SmartLead

Comprehensive SmartLead API integration for email marketing automation

Overview

This node integrates with the SmartLead API to manage leads within email marketing campaigns. Specifically, the Delete operation under the Lead Management resource allows users to delete a lead from a specified campaign. This is useful for cleaning up or removing contacts who should no longer receive campaign emails, such as unsubscribed users or invalid contacts.

Practical scenarios include:

  • Removing a lead who has requested to be deleted from a campaign.
  • Cleaning up test or duplicate leads from an active campaign.
  • Automating lead lifecycle management by deleting leads after certain conditions are met.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign from which the lead will be deleted.
Lead ID The unique identifier of the lead to be deleted from the specified campaign.

Output

The output JSON contains the response data returned by the SmartLead API after attempting to delete the lead. Typically, this will confirm whether the deletion was successful or provide error details if it failed.

The structure is generally:

{
  "data": {
    // API-specific response fields confirming deletion status
  }
}

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the SmartLead API.
  • The node makes HTTP DELETE requests to the SmartLead API endpoint:
    https://server.smartlead.ai/api/v1/campaigns/{campaignId}/leads/{leadId}

Troubleshooting

  • Invalid Campaign ID or Lead ID: If either ID is incorrect or does not exist, the API will return an error. Verify IDs before running the node.
  • Authentication Errors: Ensure the API key credential is correctly configured and has sufficient permissions.
  • Network Issues: Connectivity problems can cause request failures; check network access to the SmartLead API.
  • API Rate Limits: Excessive requests may be throttled by the API; implement retries or backoff strategies if needed.

Common error messages:

  • "Invalid JSON in lead data" — Not applicable here since no JSON input is required for delete, but relevant for other operations.
  • API error responses indicating missing or unauthorized access usually mean credential issues.

Links and References


This summary focuses exclusively on the Lead Management > Delete operation as requested.

Discussion