NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
EmailOctopus connects to a Nagent workspace with an API key. Once it is connected, agents can call 20 EmailOctopus actions, such as "Create Contact", "Create Field" and "Create List". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against EmailOctopus, with input parameters and output schema.
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
Agents can call 20 EmailOctopus actions on Nagent, including "Create Contact", "Create Field" and "Create List". Create Contact: This tool creates a new contact in EmailOctopus. Each action is listed on this page with its input parameters and its output.
EmailOctopus connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create Contact takes 2 required inputs: list_id and email_address. It also takes 3 optional inputs: tags, fields and status. It returns data, error and successful.