Skip to content
One-on-one deliverability consultationBook
Book a support call
  • There are no suggestions because the search field is empty.

EmailElement + n8n Seed List Automation

Learn how to create, synchronize, and automatically manage Warmy seed lists using EmailElement and n8n.

Cover graphic for syncing Warmy seed lists to EmailElement contacts through an n8n workflow

 

 

  👀 Please take a look in the video with the steps if you need any help 😎


 
Managing and Synchronizing Warmy Seedlists Across Email Element 

The first step is creating one or more Contact Lists in EmailElement. These Contact Lists will be used by the workflow to synchronize your Warmy seed email addresses.

Option 1: Access Contact Lists Directly
Open the following URL in your browser: https://portal.emailelement.com/contactlists

Option 2: Access Contact Lists from the Dashboard
Alternatively, sign in to your EmailElement account. From the left-hand navigation menu, click Contact Lists.

EmailElement portal with the Contact Lists item highlighted in the left menu for seed list sync
Both options will take you to the same Contact Lists page.



Once you're on the Contact Lists page, click the red Create Contact List button.
A new page will open where you'll be asked to provide a name for the Contact List and locate the Contact List Name field and enter a descriptive name.

After entering the name, scroll to the bottom of the page and click the red Create button.

EmailElement Contact Lists page with the Create Contact List button highlighted for a new seed list

EmailElement new contact list form with Seedlist_1 entered in the name field and Create button marked
You can create as many Contact Lists as your workflow requires. For this example, we'll create a second contact list.

Return to Contact Lists from the left-hand navigation menu and click the red Create Contact List button once again. This time, enter the following name: Seedlist_2

Scroll to the bottom of the page and click Create.



Navigate back to Contact Lists. You should now see both Contact Lists listed in the table.

For this example, you should have:
- Seedlist_1
- Seedlist_2

EmailElement Contact Lists table showing Seedlist_1 and Seedlist_2 with their list IDs in the first column



Now locate the Contact List IDs. Each Contact List has a unique ID displayed in the first column of the table. For example:

Contact List Contact List ID
Seedlist_1 2677
Seedlist_2 2678


EmailElement Contact Lists with the IDs 2677 and 2678 highlighted for use in the n8n mapping config

Important: Each Contact List ID is unique. You'll need these IDs later when configuring the mapping inside your n8n workflow, so keep them handy before moving to the next section.



Now that your Contact Lists have been created, it's time to configure your n8n workflow so it knows which contact list should receive the synchronized seed email addresses.

Open your n8n workflow, locate the node named: Set: Mapping Config, and click the node to open its configuration.

n8n Seed List Sync Warmy + MailElement workflow with the Set mapping config node highlighted to open



Inside the node, locate the Mode section. Make sure the editor is displaying the configuration in JSON format. Within the JSON configuration, locate the following property: "contact_list":

This value specifies the EmailElement Contact List where the workflow will synchronize your seed email addresses.

n8n Set mapping config node with Mode set to JSON and the split_info JSON editor highlighted



Now delete the existing value assigned to contact_list and replace it with the ID of the Contact List you created earlier. For this article, we'll use the ID assigned to Seedlist_1.

Example: "contact_list":2678
If you're using a different Contact List, simply replace 2678 with your own Contact List ID.

n8n mapping config JSON with the contact_list value highlighted to replace with the EmailElement list ID

Note: Don't close the Mapping Config window yet. Additional values will be configured later in this article.



The next step is return to your Email Element dashboard. From the left-hand navigation menu, click Suppression Lists.

EmailElement Contact Lists page with Suppression Lists highlighted in the sidebar to create a seed suppression list



Now, click the red Create Suppression List button, and a new page will open. Locate the Suppression List Name field and enter a name that helps you easily identify the list.

For this guide, we'll use: Seedlist supp.
Scroll to the bottom of the page and click Create.

EmailElement Create Suppression List form with the Suppression List Name field highlighted



Once the Suppression List has been created, you'll be redirected to its details page. You'll notice a Record Count: 0 indicator along with two switches:
- Global
- Active

Enable the Global switch. A confirmation dialog will appear, and you need click Confirm to continue.

EmailElement Edit Suppression List page after saving Seedlist supp with the Global switch turned on

EmailElement confirmation dialog for setting the Seedlist supp suppression list as Global with Confirm marked



Once confirmed, return to Suppression Lists using the left-hand navigation menu. Locate the suppression list you just created. Just like contact lists, every Suppression List has its own unique ID displayed in the first column of the table.

Copy this ID, as it will be required in the next section when configuring the Mapping Config node inside your n8n workflow.

EmailElement Edit Suppression List page with Suppression Lists in the sidebar highlighted to go back

EmailElement Suppression Lists table with the Seedlist supp row and its list ID 2005 highlighted



Return to your n8n workflow and reopen the Set: Mapping Config node if you've already closed it. Inside the JSON configuration, locate the following property "supp_list":

Replace the existing value with the ID of the Suppression List you created in EmailElement. This allows the workflow to automatically manage suppressed seed email addresses using the correct Suppression List.

n8n workflow canvas where the Set mapping config node is selected to enter the suppression list ID

n8n mapping config in JSON mode, where the supp_list value takes the EmailElement suppression list ID

 



Next, locate the following property "split_id":
To obtain this value, open your Warmy account and navigate to the Splits section. Copy the ID of the Split you want to use for this synchronization.

Warmy admin workspace Splits tab with copy icons next to each Split ID highlighted in the table

Return to the JSON configuration in n8n and replace the existing value with the Split ID you copied. After updating both values, review the JSON configuration to ensure everything is correct.

Once you've confirmed the configuration, close the Mapping Config window by clicking the X button in the upper-right corner.

The mapping configuration is now complete, and you're ready to continue with the webhook configuration.

n8n mapping config JSON with the second split_id value highlighted and paired with its contact list



Now that the mapping configuration is complete, the next step is to configure the webhook that will allow Warmy to notify your n8n workflow whenever a seed list event occurs.

Return to your n8n workflow, locate the node named: Webhook.
This node acts as the trigger for your automation. Click the node to open its configuration.

n8n workflow with the Webhook trigger node highlighted to connect it to Warmy notifications



Inside the Webhook node, locate the Production URL button. Click it to display the production endpoint. A POST URL will appear.
Copy the entire URL, as you'll use it in the next step when configuring Warmy notifications.

n8n Webhook node with the Production URL tab selected and the POST webhook address ready to copy

Important: Make sure you copy the Production URL, not the Test URL.


To configure the Webhook in Warmy, open your Warmy dashboard in a new browser tab.
From the left-hand navigation menu, click Notifications Hub.

Warmy dashboard sidebar with the Notifications hub item highlighted under Insights and tools
The Notifications Hub displays all available notification channels. Locate the Webhooks card and enable the Webhooks integration by turning on the switch.

Once enabled, a configuration window will appear. Paste the Production Webhook URL that you copied from n8n into the URL field. Click Save to apply the changes.

Warmy Notifications Hub with the Webhooks toggle highlighted to enable webhook notifications

Warmy Webhooks window with the n8n production webhook URL pasted into the field and Save marked

 



After saving the webhook URL, you'll see several notification events available. For this workflow, leave Seedlist Notification enabled. Disable any other notification events that are currently selected.

This ensures that only the required webhook events are sent to your n8n workflow. Your webhook configuration is now complete.

Warmy Notifications Hub with a connected webhook and mailbox notification checkboxes cleared in that column

Warmy Notifications Hub Seed List Notifications section with updated and rotated webhook checkboxes ticked

Important: Keep your Warmy dashboard open. You'll use it again in the next steps to generate your API credentials.



To configure the Warmy Node Credentials, return to your n8n workflow.
Close the Webhook node if it's still open. Locate the node named: Warmy

Click the node to open its configuration. Inside the node, locate the Credentials field, click the pencil icon to edit the existing credentials. If you've already configured your credentials, you'll see fields for:
- API Token
- Holder UID

n8n Get split emails node for Warmy with the credential pencil icon highlighted



n8n Warmy API credential window with the API Token and Holder UID fields highlighted

If you haven't created these credentials yet, follow the steps below.



Return to your Warmy dashboard and expand your current Workspace by clicking its name. A menu will appear; click Settings. Inside the Settings page, select API Keys.

Click the + API Key button. A new window will open; enter a name that will help you identify this API key.

Warmy Notifications Hub with the workspace gear menu open and Settings highlighted

Warmy workspace settings with the API Keys tab highlighted in the left submenu

For this guide, we'll use: MailElement Update/Rotate n8n Workflow, and click Create Key.
Once the key has been generated, copy the API Key. Keep it somewhere safe, as you'll need it immediately in the next step.

Warmy workspace settings API Keys page with the plus API Key button highlighted to create a key

Warmy API Keys list showing the new MailElement key with the masked key value highlighted to copy

 



Now, return to the Credentials window you previously opened in n8n. Locate the API Token field. Remove the existing value, if any. Paste the API Key you copied from Warmy.
n8n Warmy API credential with the API Token field highlighted to paste the new Warmy API key

 

Locate the node named: DataTable: Get Synced State. Click the node to open its configuration. Locate the Data Table field. Next, click inside the dropdown list.

Later in this guide, you'll select the data table named: mailelement_seed_state
If it doesn't exist yet, don't worry. You'll create it in the next section. Close the node once you've reviewed its configuration.

n8n workflow with the DataTable get synced state node highlighted, used to track synced seed state

n8n DataTable get synced state node with the data table dropdown showing mailelement_seed_state selected

 



Open a new browser tab and sign in to your n8n instance.
From the left-hand navigation menu, click Data Tables. Click the orange Create Data Table button.

n8n DataTable node dropdown with a browser tab marked to open n8n data tables overview

n8n Data tables page with the Data tables tab and Create data table button highlighted

Note: Keep your original workflow tab open. You'll return to it after creating the Data Table.

A dialog window will appear. Configure it as follows: Table Name like mailelement_seed_state. 
For the creation method, leave From Scratch selected, then
click Create.

Once the table has been created, double-click it to open it. Next, click Add Column.
Create the following columns, and all columns should use the String data type. After adding all five columns, save the Data Table. Your Data Table is now ready to be used by the workflow.

Column Name
The seed's email address
Warmy Split ID this row belongs to
MailElement Contact List ID this row belongs to
Status (currently synced or removed)
Timestamp of the last write to this row

n8n Create new data table dialog with the name field highlighted for mailelement_seed_state

n8n data table view with the String columns to add for seed state tracking highlighted

 



Return to your original n8n workflow tab. Open the DataTable: Get Synced State node again. In the Data Table field, select: mailelement_seed_state and close the node.

n8n DataTable get synced state node with mailelement_seed_state chosen in the data table list

Next, open the node named: DataTable: Upsert Balanced Active. In the Data Table field, select: mailelement_seed_state and close the node.

n8n workflow with the DataTable node for balanced seed state highlighted for table selectionn8n DataTable upsert balanced active node with mailelement_seed_state highlighted in the data table field



Repeat exactly the same process for the node named: DataTable: Upsert Removed Suppressed. Select the same Data Table. Close the node once you've finished. At this point, all Data Table nodes should be pointing to the same table.

n8n workflow with the upsert balanced active and upsert removed suppressed DataTable nodes highlighted

n8n DataTable upsert removed suppressed node with the mailelement_seed_state table highlighted



Before continuing, it's a good idea to perform one final verification. Open the Set: Mapping Config node again and review the JSON configuration and confirm that all values are correct, including:

- Contact List ID
- Suppression List ID
- Split ID

If everything looks correct, close the node. Your workflow configuration is now ready for the final authentication steps.

n8n workflow canvas with the DataTable get synced state node highlighted for a final checkn8n Set mapping config node with the JSON holding split IDs, contact lists and suppression list highlighted

 



The workflow is almost ready. The next step is to create an API Key in EmailElement, so n8n can securely communicate with your EmailElement account.

Return to your EmailElement dashboard. From the left-hand navigation menu, click Account. Next, select API Keys.

Click the + Add button. A dialog window will appear. In the Name field, enter a descriptive name that helps you identify the key later.

For this guide, we'll use: Test API Key. Under the Permissions section, select: Full Access and click Create.

Once the API Key has been generated, open it and click Copy API Key. Keep the copied value available, as you'll use it immediately in the next step.

EmailElement Contact Lists page with the Account item highlighted in the left menuEmailElement Account settings with the API Keys tab highlighted next to Profile

EmailElement Account API Keys tab with the Add button highlighted to generate a new API key

EmailElement Add New Record dialog with the key name entered and Full Access permission highlightedEmailElement API Keys list showing the new Test API key with FullAccess permission highlighted

EmailElement API key details dialog with the Copy button highlighted next to the masked API key



Now return to your n8n workflow. Locate the node named: HTTP: Add to Suppression List.
Click the node to open its configuration.

Locate the Authentication field. Open the dropdown menu and select: Generic Credential Type
A new option named Generic Auth Type will appear. 

Select: Header Auth. In the Credentials field, choose your EmailElement credential. If it hasn't been created yet, click Edit and the credential configuration window will open.

Verify that the following values are configured correctly: name: x-api-key and the value:  Paste the EmailElement API Key that you copied in the previous step.

Click Save. Close both the credentials window and the HTTP node. Your EmailElement authentication is now complete.

n8n workflow with the HTTP add to suppression list node highlighted to open it

n8n HTTP add to suppression list node with the Authentication dropdown highlighted

n8n HTTP node Header Auth fields with the pencil icon highlighted to edit MailElement credentials

n8n MailElement Header Auth credential with the x-api-key name and masked API key value highlighted

Before running the workflow, perform one final review to make sure every required component has been configured correctly.

Confirm that: Once everything has been verified, you're ready to test the automation.



Return to your EmailElement dashboard. Open Contact Lists. As the workflow executes, you'll begin to see your Warmy seed email addresses automatically synchronized into the Contact Lists that you configured earlier.

This synchronization is triggered by Warmy events and processed automatically by the n8n workflow. Depending on the number of Contact Lists you've configured, synchronization may occur in multiple stages. Allow the workflow to continue running until all Contact Lists have been processed.

EmailElement Contact Lists menu item highlighted to verify seed sync results after the workflow ran

After the workflow finishes processing, refresh the Contact Lists page in EmailElement.

You should now see that the Warmy seed email addresses have been distributed across the Contact Lists created earlier.

For example:
- Seedlist_1
- Seedlist_2

Both lists should now contain synchronized seed email addresses.

EmailElement Contact Lists with Seedlist_2 record count 503 highlighted after the n8n sync workflow



Next, verify that suppression synchronization is also working correctly. From the Contact Lists page, click the Suppressed Count icon for one of your Contact Lists.

The corresponding Suppression List should display the synchronized records generated by the workflow. Repeat this verification for your remaining Contact Lists if necessary.

EmailElement Contact Lists with the suppressed count icon highlighted to review suppression lists


One of the main purposes of this integration is keeping EmailElement synchronized whenever Warmy rotates seed email addresses.

Return to your n8n workflow and allow it to continue listening for webhook events.
When Warmy performs a rotation or update event, the webhook will automatically trigger the workflow.

Once the execution finishes, return to EmailElement. Refresh the Contact Lists page.
You'll notice that the synchronized seed email addresses have been updated automatically.
No manual intervention is required.

You can also open the Suppressed Count for each Contact List to confirm that removed seed email addresses have been correctly transferred to the Suppression List.

This verifies that both active and removed seeds are being synchronized successfully.



How to Configure Warmup Workflows for MailElement

Cover illustration for configuring Warmy warm-up workflows with MailElement contact and suppression lists