EmailOctopus is an email marketing platform founded in 2015, offering affordable and intuitive solutions for individuals and businesses to connect with their subscribers.
EmailOctopus is an email marketing platform founded in 2015, offering affordable and intuitive solutions for individuals and businesses to connect with their subscribers. On Nagent, EmailOctopus is exposed as a fully-configurable email newsletters integration that any agent can call — 20 actions, and API key authentication. No code is required to wire EmailOctopus into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use EmailOctopus to automate the kinds of tasks email newsletters teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire EmailOctopus into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against EmailOctopus, with input parameters and output schema. Drop these into any step of an agent built in Helix.
EMAILOCTOPUS_CREATE_CONTACTThis tool creates a new contact in EmailOctopus. The tool will add a contact to a specified list with the provided information.
Input parameters
Tags to associate with the contact for segmentation and filtering purposes.
Custom field values for the contact. Keys should be field tags (e.g., 'FirstName', 'LastName'). Use the 'Get All Lists' action to see available field tags for a list.
The subscription status of the contact. Accepted values: 'subscribed', 'unsubscribed', or 'pending' (case-insensitive). Defaults to 'subscribed' if not provided.
The unique identifier (UUID) of the EmailOctopus list to add the contact to. Use the 'Get All Lists' action to retrieve available list IDs.
The email address of the contact to create. Must be a valid email format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_CREATE_FIELDTool to create a new custom field on an EmailOctopus mailing list. Use when you need to add additional data fields beyond the default Email, First Name, and Last Name fields.
Input parameters
The tag used to reference this field in templates and API calls (e.g., 'Company', 'PhoneNumber'). Should be unique within the list.
The data type of the custom field. Use 'text' for strings, 'number' for numeric values, or 'date' for dates.
The display label for the custom field (e.g., 'Company', 'Phone Number'). This is what users will see in forms and settings.
The unique identifier (UUID) of the EmailOctopus list to add the custom field to. Use the 'Get All Lists' action to retrieve available list IDs.
Default value to use when the field is empty. This value will be used in email templates when no value is provided for a contact.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_CREATE_LISTCreates a new mailing list in EmailOctopus for organizing and managing email contacts. The list is created with default fields (Email address, First name, Last name) and can be used to add contacts, send campaigns, and track subscriber engagement.
Input parameters
The name of the new mailing list. Must be between 2-255 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_CREATE_TAGTool to create a new tag on an EmailOctopus mailing list. Use when you need to add a new tag for contact segmentation and filtering purposes.
Input parameters
The name of the tag to create. Used for segmentation and filtering contacts within the list.
The unique identifier (UUID) of the EmailOctopus list to create the tag in. Use the 'Get All Lists' action to retrieve available list IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_DELETE_CONTACTPermanently deletes a contact from a specified EmailOctopus list. This action is irreversible - once deleted, the contact and all associated data will be removed from the list. Use this for list management, honoring deletion requests, and data privacy compliance (e.g., GDPR right to erasure).
Input parameters
The unique identifier (UUID) of the EmailOctopus list containing the contact. Use the 'Get All Lists' action to retrieve available list IDs.
The unique identifier (UUID) of the contact to delete, or an MD5 hash of the lowercase version of the contact's email address. Use the 'Create Contact' action response or list contacts to find contact IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_DELETE_FIELDPermanently deletes a custom field from a specified EmailOctopus list. This action is irreversible - once deleted, the field and all associated data will be removed from the list. Use this for list customization and field management.
Input parameters
A unique identifier for the custom field to delete (e.g., 'Hometown', 'TestDeleteField'). This is the field tag, not the field name.
The unique identifier (UUID) of the EmailOctopus list containing the field. Use the 'Get All Lists' action to retrieve available list IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_DELETE_LISTThis tool allows you to delete an existing mailing list from your EmailOctopus account. Once a list is deleted, it cannot be recovered, and all contacts within the list will be permanently removed. Note: Lists can only be deleted if no contacts within the list have received an email in the last 7 days.
Input parameters
The unique identifier of the list to be deleted
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_DELETE_TAGTool to delete a tag from a mailing list in EmailOctopus. Use when you need to remove an existing tag that is no longer needed for contact organization or segmentation.
Input parameters
A unique identifier for the tag to be deleted
The unique identifier (UUID) of the EmailOctopus list containing the tag
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_GET_ALL_LISTSThis tool retrieves all the mailing lists associated with the EmailOctopus account.
Input parameters
Maximum number of lists to return per page. Defaults to 100 if not specified.
Cursor for pagination. Use the 'starting_after' value from the previous response's paging.next object to retrieve the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_GET_CONTACTTool to retrieve details of a specific contact from an EmailOctopus list. Use when you need to fetch contact information including email, fields, tags, and subscription status.
Input parameters
The unique identifier (UUID) of the EmailOctopus list containing the contact. Use the 'Get All Lists' action to retrieve available list IDs.
The unique identifier (UUID) of the contact, or an MD5 hash of the lowercase version of the contact's email address.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_GET_LISTRetrieves details of a specific mailing list by ID. Use when you need to fetch list information, including its name, fields, tags, contact counts, and opt-in settings.
Input parameters
The unique identifier (UUID) of the list to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_GET_RECENT_CAMPAIGNSThis tool retrieves a list of recent campaigns from the EmailOctopus account.
Input parameters
Maximum number of campaigns to return per page (1-100, default 100)
Cursor token for pagination. Use the 'starting_after' value from the previous response's paging.next to fetch the next page.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_LIST_CONTACTSTool to retrieve contacts from an EmailOctopus list. Returns a paginated list of contacts with optional filtering by tag, status, and date ranges.
Input parameters
Filter contacts by a specific tag. Only contacts with this tag will be returned.
Maximum number of contacts to return per page (1-100, default 100)
Filter contacts by subscription status. Defaults to 'subscribed' if not specified.
The unique identifier (UUID) of the EmailOctopus list. Use the 'Get All Lists' action to retrieve available list IDs.
Filter by creation date - greater than or equal to. Must be in ISO 8601 format (e.g., 2024-01-19T12:14:28Z).
Filter by creation date - less than or equal to. Must be in ISO 8601 format (e.g., 2024-01-19T12:14:28Z).
Cursor token for pagination. Use the 'starting_after' value from the previous response's paging.next to fetch the next page.
Filter by last update date - greater than or equal to. Must be in ISO 8601 format (e.g., 2024-01-19T12:14:28Z).
Filter by last update date - less than or equal to. Must be in ISO 8601 format (e.g., 2024-01-19T12:14:28Z).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_LIST_TAGSTool to retrieve all tags from a mailing list. Use when you need to see what tags are available on a specific list for contact segmentation.
Input parameters
Maximum number of tags to return per page. Defaults to 100 if not specified.
The unique identifier (UUID) of the mailing list to retrieve tags from. Use the 'Get All Lists' action to retrieve available list IDs.
Cursor for pagination. Use the 'starting_after' value from the previous response's paging.next object to retrieve the next page of results.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_UNSUBSCRIBE_CONTACTUnsubscribes a contact from an EmailOctopus mailing list. This tool updates the contact's subscription status to 'unsubscribed', which stops them from receiving future emails from the specified list. The contact record is preserved but marked as unsubscribed.
Input parameters
The unique identifier (UUID) of the EmailOctopus list containing the contact. Use 'Get All Lists' to retrieve available list IDs.
The unique identifier (UUID) of the contact to unsubscribe. Use 'Get All Contacts' or 'Create Contact' to obtain contact IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_UPDATE_CONTACTS_BATCHTool to update multiple contacts in an EmailOctopus list in a single batch operation. Use when you need to efficiently update multiple contacts at once with changes to their email, fields, status, or tags.
Input parameters
The unique identifier (UUID) of the EmailOctopus list containing the contacts to update. Use 'Get All Lists' to retrieve available list IDs.
Array of contacts to update. Each contact must have an 'id' field. Other fields (email_address, fields, status, tags) are optional and will only update if provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_UPDATE_FIELDUpdates an existing custom field on an EmailOctopus list including its label, tag, type, and fallback value. Use this action to modify field properties or rename field tags. Note that changing the tag will affect how the field is referenced in email templates.
Input parameters
The tag identifier for the field. This can be the same as current_tag to keep it unchanged, or a new value to rename the field tag. Must be a unique identifier.
The type of the field. Determines what kind of data can be stored.
A human-readable label for the field. This is what users will see when filling out forms.
The unique identifier (UUID) of the list containing the field to update. Use the 'Get All Lists' action to retrieve available list IDs.
A default value for the field, used in campaigns when there is no other value available. Set to null or omit to remove the fallback value.
The current tag identifier of the field to update (e.g., 'Hometown', 'TestUpdateField'). This identifies which field to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_UPDATE_LISTTool to update an existing mailing list's name in EmailOctopus. Use when you need to rename a list.
Input parameters
The new name for the mailing list. Must be between 2-255 characters.
The unique identifier (UUID) of the list to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_UPDATE_TAGTool to update an existing tag on a mailing list. Use when you need to rename a tag.
Input parameters
The current name of the tag to update. This is the existing tag identifier.
The unique identifier (UUID) of the list containing the tag to update. Use the 'Get All Lists' action to retrieve available list IDs.
The new name to assign to the tag. This will replace the existing tag name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
EMAILOCTOPUS_UPSERT_CONTACTTool to create or update a contact in EmailOctopus. If the contact does not exist, it will be created. If the contact already exists, it will be updated. Use when you need to ensure a contact exists with specific information regardless of whether they're already in the list.
Input parameters
An object containing key/value pairs for tag management. Set tag name as key and true to add the tag or false to remove it. Tags not referenced in this object will not be updated.
Custom field values for the contact. Keys should be field tags (e.g., 'FirstName', 'LastName'). Values can be text (string), number (integer), date (string in ISO format), or null to unset a field. Use the 'Get All Lists' action to see available field tags for a list.
The subscription status of the contact. Accepted values: 'subscribed', 'unsubscribed', or 'pending' (case-insensitive). If not provided, defaults to the contact's current status (for updates) or 'subscribed' (for new contacts).
The unique identifier (UUID) of the EmailOctopus list. Use the 'Get All Lists' action to retrieve available list IDs.
The email address of the contact to create or update. Must be a valid email format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 33 agents privately built on Nagent that already use EmailOctopus.
Build on Nagent
Connect EmailOctopus to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find EmailOctopus, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, EmailOctopus is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once EmailOctopus is connected, you configure its 20 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop EmailOctopus steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a EmailOctopus event fires, the agent kicks off automatically.
Every EmailOctopus action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While EmailOctopus ships with 20 pre-built email newsletters actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching EmailOctopus together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build EmailOctopus-based workflows tailored to your business.