Actions6
Overview
This node integrates with Utopian Labs AI to assist in researching and engaging with leads, specifically focusing on writing email sequences. It automates the creation of personalized email campaigns by generating a sequence of emails tailored to a lead's company and profile information. This is particularly useful for sales and marketing teams aiming to streamline outreach efforts and improve engagement rates.
Typical use cases include:
- Generating multi-step email sequences for lead nurturing.
- Automating personalized email content based on lead data.
- Testing email generation workflows without sending actual emails (using mock responses).
For example, a user can input a lead’s company website and additional details, select an AI agent and language, specify the number of emails in the sequence, and receive a ready-to-use email sequence for outreach.
Properties
| Name | Meaning |
|---|---|
| Lead Company Website | The website URL of the lead's company. Must be a valid URL format. |
| To use the result of this agent run, add a Wait node and set it to "On Webhook Call". Important: Make sure the Wait Node is set to POST. The webhook URL will automatically be set by the default parameter. |
A notice guiding users to configure a Wait node properly to handle callbacks from this node. |
| Callback Url | The URL from the Wait node where the callback will be sent after processing. Defaults to the workflow's resume URL. |
| Return Mock Response | Boolean flag indicating whether to return a mock response instead of running the actual agent. Useful for testing workflows without triggering real API calls. |
| Agent | The AI agent used to write the email sequence. Options: "Copywriting Agent" or "Copywriting Agent Light". |
| Language | The language in which the email sequence will be written. Options include British English, American English, Dutch, German, French, Spanish, Portuguese, Italian. |
| Number of Emails | The number of emails to generate in the sequence. Must be between 2 and 5. Default is 3. |
| Sender Full Name | The full name of the person sending the emails. |
| Additional Fields | A collection of optional fields providing more context about the lead and their company, including: - Lead Company Name - Lead Company Description - Lead Full Name - Lead Business Email Address (must be business email) - Lead LinkedIn Profile URL - Lead Job Title - Lead X/Twitter Handle - Max Research Steps (max number of research steps to perform, default 5) - Context (additional context for the operation) - Use Memory (whether to use previous research runs where applicable) |
Output
The node outputs JSON data representing the generated email sequence. Each item corresponds to one input lead and contains the AI-generated email content structured according to the requested number of sequence steps.
- The
jsonoutput includes the detailed email sequence text and metadata returned from the Utopian Labs API. - If the "Return Mock Response" option is enabled, the output will contain a simulated response useful for testing.
- No binary data output is produced by this node.
Dependencies
- Requires an active connection to the Utopian Labs API via an API key credential configured in n8n.
- The node expects a properly configured Wait node in the workflow to handle asynchronous callbacks (webhook POST requests).
- Network access to the Utopian Labs API endpoint
/v1/n8n/runsis necessary.
Troubleshooting
- Invalid Email Address Error: If the provided lead email is not in a valid business email format, the node throws an error. Ensure the email matches standard email regex and is not from blocked domains.
- Invalid Website URL Error: The lead company website must be a valid URL. Check for typos or missing protocol prefixes.
- Missing Lead Full Name: When any lead-specific information like email, LinkedIn, job title, or social handle is provided, the lead's full name is mandatory.
- Callback URL Misconfiguration: The Wait node must be set to listen for POST requests at the specified callback URL; otherwise, the workflow may hang waiting for a response.
- API Authentication Issues: Ensure the API key credential is correctly set up and has permissions to call the Utopian Labs API.
- Exceeded Research Steps: The max research steps should be reasonable (default 5); setting too high may cause delays or failures.