SmartLead

Comprehensive SmartLead API integration for email marketing automation

Actions37

Overview

The node integrates with the SmartLead API to manage leads within email marketing campaigns. Specifically, the Update operation under the Lead Management resource allows users to update information about a specific lead identified by its Lead ID. This can include modifying lead details or attributes as supported by the API.

This node is beneficial in scenarios where you need to programmatically maintain and update lead data during an email marketing workflow, such as correcting lead information, updating lead status, or syncing lead details from other systems.

Example use cases:

  • Automatically update lead contact details when new information is received.
  • Change lead attributes based on campaign interactions or external triggers.
  • Maintain accurate lead records without manual intervention.

Properties

Name Meaning
Lead ID The unique identifier of the lead to update.
Additional Fields Optional fields to specify extra parameters such as:
- Limit: Number of results to return
- Offset: Number of results to skip
- Status: Campaign status (Active, Paused, Stopped)

Note: For the Update operation, the main required property is Lead ID. The "Additional Fields" collection may be used depending on context but primarily applies to other operations.

Output

The node outputs JSON data representing the updated lead information returned by the SmartLead API. The structure typically includes the lead's current attributes after the update.

  • The output is an array of JSON objects, each corresponding to an input item processed.
  • Each object contains the updated lead data as returned by the API.
  • No binary data output is produced by 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 for all requests.
  • Proper permissions on the API key are necessary to perform lead updates.

Troubleshooting

  • Common issues:

    • Invalid or missing Lead ID will cause the API request to fail.
    • Insufficient API permissions may result in authorization errors.
    • Network connectivity problems can prevent successful API calls.

  • Error messages:

    • "Lead not found": Verify that the Lead ID exists and is correct.
    • "Unauthorized" or "Forbidden": Check API key validity and permissions.
    • "Bad Request": Ensure all required fields are correctly formatted and provided.

  • Resolution tips:

    • Double-check the Lead ID input for typos.
    • Confirm API credentials are set up and have the necessary scopes.
    • Review additional fields for correctness if used.

Links and References

Discussion