SmartLeadInstall

Overview

The node integrates with the SmartLead API to manage leads within email marketing campaigns. Specifically, the Update Category operation under the Lead Management resource allows users to update the category of leads associated with a particular campaign. This is useful for segmenting leads dynamically based on their behavior or status in a campaign.

Common scenarios include:

• Reclassifying leads into different categories after certain interactions.
• Organizing leads for targeted follow-ups or reporting.
• Automating lead lifecycle management by updating categories programmatically.

Example: Automatically move leads from a "Prospect" category to a "Customer" category after a successful purchase event tracked in your workflow.

Properties

Note: The operation does not require additional input fields beyond the campaign ID for this action, as the category update payload is sent in the request body internally (not exposed as an input property here).

Output

The output JSON contains the response data from the SmartLead API after attempting to update the lead category. Typically, this includes confirmation of the update or details about the affected leads.

The structure is:

{
  "data": { /* API response object related to category update */ }
}

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 sends authenticated HTTP requests to https://server.smartlead.ai/api/v1.
• Proper permissions on the API key are necessary to update lead categories within campaigns.

Troubleshooting

• Invalid JSON Errors: If you manually provide JSON inputs (in other operations), ensure they are well-formed. For this operation, the node handles JSON internally.
• Authentication Failures: Verify that the API key credential is valid and has sufficient permissions.
• Campaign ID Issues: Ensure the provided Campaign ID exists and is accessible by the API key user.
• API Errors: The node throws errors if the API returns failures; check the error message for details such as invalid parameters or rate limits.

Links and References

• SmartLead API Documentation (general reference for endpoints)
• SmartLead Lead Management Guide (for understanding lead categories and usage)

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