Smartlead icon

Smartlead

Interact with the Smartlead.ai API

Actions39

Lead → Update

AI-generated

Overview

This node integrates with the Smartlead.ai API to manage leads within email marketing campaigns. Specifically, the "Lead - Update" operation allows users to update information for a specific lead in a given campaign by setting one or more fields to new values.

Typical use cases include:

  • Correcting or enriching lead data such as company name, contact details, or custom attributes.
  • Updating lead status or other metadata dynamically based on external triggers or workflows.
  • Keeping lead information synchronized between Smartlead and other systems.

For example, you might update a lead's company name and phone number after receiving updated contact info from a CRM system.

Properties

Name Meaning
Campaign ID The unique identifier of the campaign containing the lead to update.
Lead ID The unique identifier of the lead to update within the specified campaign.
Fields to Update A collection of key-value pairs specifying which lead fields to update and their values.
Each field has:
- Key: The name of the lead field (e.g., company_name).
- Value: The new value to assign to that field.

Output

The node outputs the JSON response returned by the Smartlead API after updating the lead. This typically includes the updated lead object or confirmation of the update operation.

The output is structured as an array of JSON objects corresponding to each input item processed. Each object contains the API response data for that particular update request.

No binary data output is produced by this operation.

Dependencies

  • Requires an active connection to the Smartlead.ai API via an API key credential configured in n8n.
  • The node uses the base URL https://server.smartlead.ai/api/v1 for all API requests.
  • Proper permissions on the API key are necessary to update leads within campaigns.

Troubleshooting

  • Invalid Campaign ID or Lead ID: If the provided IDs do not exist or are incorrect, the API will return an error. Verify the IDs before running the node.
  • Empty or Incorrect Fields to Update: Ensure that the keys correspond to valid lead field names recognized by Smartlead. Invalid keys may cause the update to fail.
  • Authentication Errors: Confirm that the API key credential is correctly set up and has sufficient permissions.
  • API Rate Limits or Network Issues: Temporary failures may occur due to rate limiting or connectivity problems. Retrying the operation can help.
  • Error Messages: The node throws errors with messages returned by the API. Review these messages to identify issues such as missing required fields or invalid data formats.

Links and References

Discussion