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 Block List" operation under the "Lead Management" resource allows users to add a lead's email address or domain to a global block list, preventing further communication with that lead across all campaigns.

Common scenarios for this node include:

  • Automatically blocking leads who have unsubscribed or reported spam.
  • Managing a centralized block list to maintain compliance and improve sender reputation.
  • Preventing emails from being sent to problematic or invalid addresses.

For example, after identifying a lead who should no longer receive emails, you can use this node to add their email to the block list, ensuring they are excluded from future campaigns.

Properties

Name Meaning
Additional Fields Optional parameters including:
• Limit: Number of results to return (default 100)
• Offset: Number of results to skip (default 0)
• Status: Campaign status filter with options Active, Paused, Stopped (default Active)

Note: For the "Add to Block List" operation, the main required input is the Email Address of the lead to be blocked, which is passed as the email parameter in the request body.

Output

The node outputs JSON data representing the response from the SmartLead API after adding the lead to the block list. The output structure typically includes confirmation details such as the blocked email address and any relevant metadata returned by the API.

No binary data is produced by this operation.

Dependencies

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

Troubleshooting

  • Common issues:

    • Invalid or missing email address input will cause the API call to fail.
    • Authentication errors if the API key credential is not set up correctly.
    • Network connectivity issues preventing access to the SmartLead API server.

  • Error messages:

    • Errors returned from the API will be included in the node output if "Continue on Fail" is enabled.
    • Typical error messages may include "Unauthorized" (check API credentials), "Bad Request" (verify email format), or "Not Found" (invalid campaign or lead ID if applicable).

  • Resolution tips:

    • Ensure the email address is valid and properly formatted.
    • Verify API credentials and permissions.
    • Check network connectivity and API endpoint availability.

Links and References

Discussion