SmartLead

Comprehensive SmartLead API integration for email marketing automation

Actions37

Overview

The "Unsubscribe from All" operation in the Lead Management resource allows users to unsubscribe a lead (identified by their email address) from all email campaigns managed via the SmartLead platform. This is useful when a lead no longer wishes to receive any communications, ensuring compliance with opt-out requests and improving user experience.

Typical use cases include:

  • Automatically unsubscribing leads who request to stop all marketing emails.
  • Cleaning up mailing lists by removing contacts who have opted out globally.
  • Integrating unsubscribe requests from external sources or forms into the SmartLead system.

Properties

Name Meaning
Email Address The email address of the lead to unsubscribe from all campaigns.
Additional Fields Optional parameters including:
• Limit: Number of results to return (not used here).
• Offset: Number of results to skip (not used here).
• Status: Campaign status filter (Active, Paused, Stopped) (not used here).

Note: For this specific operation ("Unsubscribe from All"), only the Email Address property is required and relevant.

Output

The node outputs JSON data representing the response from the SmartLead API after attempting to unsubscribe the lead from all campaigns. The structure typically includes a data field containing details about the unsubscription result, such as confirmation or status messages.

Example output JSON structure:

{
  "data": {
    // Details about the unsubscription action, e.g., success confirmation
  }
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the SmartLead API service.
  • Needs an API authentication token configured in n8n credentials for the SmartLead API.
  • The base URL for API requests is https://server.smartlead.ai/api/v1.

Troubleshooting

  • Common issues:

    • Invalid or missing email address parameter will cause the API call to fail.
    • Network connectivity problems or incorrect API credentials can prevent successful communication with the SmartLead API.
    • If the lead email does not exist in the system, the API may return an error or empty response.

  • Error messages:

    • Errors returned from the API are propagated by the node. Typical errors might include "Lead not found" or "Unauthorized".
    • To resolve, verify the email address is correct and exists in the SmartLead system.
    • Ensure that the API key credential is valid and has sufficient permissions.
    • Check network access and endpoint availability.

Links and References

Discussion