SmartLead icon

SmartLead

Comprehensive SmartLead API integration for email marketing automation
Join our community

Actions74

Overview

The node integrates with the SmartLead API to manage email marketing campaigns. Specifically, the Update General Settings operation under the šŸŽÆ Campaign Management resource allows users to modify various general settings of an existing campaign. This includes tracking preferences, lead stopping criteria, unsubscribe text, email format, follow-up percentage, client association, AI matching options, and renaming the campaign.

This operation is beneficial when you want to fine-tune how a campaign behaves without recreating it. For example, you might want to disable tracking of email opens for privacy reasons, change the unsubscribe message to comply with new regulations, or adjust the percentage of leads that receive follow-ups based on campaign performance.

Practical examples:

  • Disabling link click tracking in a campaign to reduce tracking overhead.
  • Changing the campaign name to reflect a new marketing focus.
  • Setting the campaign to send plain text emails instead of HTML for better deliverability.
  • Adjusting the follow-up percentage to target only a subset of leads.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign to update (required).
Track Settings Options to disable specific tracking features: "Don't Track Email Open", "Don't Track Link Click", "Don't Track Reply to Email". Multiple can be selected. Default disables email open tracking.
Stop Lead Settings Condition to stop sending emails to a lead: "Click on a Link", "Open an Email", or "Reply to an Email". Default is "Reply to an Email".
Unsubscribe Text Custom text shown to recipients for unsubscribing from the campaign.
Send as Plain Text Boolean flag indicating whether emails should be sent as plain text instead of HTML.
Follow Up Percentage Number (0-100) representing the percentage of leads to follow up with in the campaign.
Client ID Numeric client identifier associated with the campaign; optional and can be left empty.
Enable AI ESP Matching Boolean flag to enable AI-based Email Service Provider matching for the campaign.
Campaign Name New name for the campaign; if left empty, the current name remains unchanged.

Output

The output JSON contains the response data from the SmartLead API after updating the campaign settings. Typically, this will include the updated campaign object reflecting the changes made.

The node outputs the API response in the json field of the item, structured as an array of objects corresponding to each input item processed.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the SmartLead API via an API key credential configured in n8n.
  • The node uses the base URL https://server.smartlead.ai/api/v1.
  • Proper permissions on the API key are necessary to update campaign settings.

Troubleshooting

  • Invalid Campaign ID: If the provided campaign ID does not exist or is malformed, the API will return an error. Verify the campaign ID before running the node.
  • Invalid Property Values: Providing invalid values for properties like followUpPercentage (outside 0-100) or unsupported strings may cause API errors.
  • JSON Parsing Errors: Although this operation does not require JSON input fields, other operations do. Ensure JSON inputs are well-formed to avoid parsing errors.
  • API Authentication Errors: Ensure the API key credential is valid and has sufficient permissions.
  • Network Issues: Connectivity problems to the SmartLead API endpoint will cause request failures.

Links and References

  • SmartLead API Documentation (general reference for API endpoints and parameters)
  • n8n documentation on HTTP Request Node for understanding API integrations
  • Best practices for email marketing compliance and tracking settings (varies by region)

If you need details on other operations or resources, feel free to ask!

Discussion