SmartLead

Comprehensive SmartLead API integration for email marketing automation

Actions37

Overview

This node integrates with the SmartLead API to manage email accounts, campaigns, leads, and analytics for email marketing automation. Specifically, the Update Warmup operation under the Email Accounts resource allows users to update warmup settings of a specified email account. Email warmup is a process that gradually increases the volume of emails sent from a new or dormant email account to build its reputation and avoid spam filters.

Typical use cases include:

  • Adjusting warmup parameters for an email account to optimize deliverability.
  • Automating warmup updates as part of an email marketing workflow.
  • Managing multiple email accounts’ warmup settings programmatically.

Example: A user can update the warmup status or configuration of an email account before adding it to a campaign to ensure better inbox placement.

Properties

Name Meaning
Email Account ID The unique identifier of the email account whose warmup settings you want to update.
Additional Fields Optional fields to customize the request:
- Limit Number of results to return (used in some operations, not directly relevant here).
- Offset Number of results to skip (used in some operations, not directly relevant here).
- Status Campaign status filter with options: Active, Paused, Stopped (not directly relevant here).

Note: For the Update Warmup operation, only the Email Account ID is required. The "Additional Fields" collection is available but may not apply directly to this operation.

Output

The node outputs JSON data returned by the SmartLead API after updating the warmup settings of the specified email account. The output structure typically includes the updated warmup configuration or status information related to the email account.

The json output field contains an array of objects representing the response data from the API. Each object corresponds to the updated warmup details for the email account.

No binary data output is involved in this operation.

Dependencies

  • Requires an active connection to the SmartLead API.
  • Requires an API key credential configured in n8n for authentication with the SmartLead service.
  • The base URL used is https://server.smartlead.ai/api/v1.
  • The node uses HTTP POST method to update warmup settings at endpoint /email-accounts/{emailAccountId}/warmup.

Troubleshooting

  • Common issues:

    • Invalid or missing Email Account ID will cause the API call to fail.
    • Authentication errors if the API key credential is not set up correctly.
    • Network connectivity issues preventing access to the SmartLead API server.
    • Attempting to update warmup on an email account that does not support warmup or is inactive.

  • Error messages:

    • "401 Unauthorized": Check API key credential validity and permissions.
    • "404 Not Found": Verify the Email Account ID exists and is correct.
    • "400 Bad Request": Ensure all required parameters are provided and valid.
    • "500 Internal Server Error": Temporary server issue; retry later or contact support.

  • To resolve errors, verify input parameters, confirm API credentials, and check network connectivity.

Links and References

Discussion