# EmailOctopus

EmailOctopus is an email marketing platform founded in 2015, offering affordable and intuitive solutions for individuals and businesses to connect with their subscribers.

- **Category:** email newsletters
- **Auth:** API_KEY
- **Tools:** 20
- **Triggers:** 0
- **Slug:** `EMAILOCTOPUS`
- **Version:** 20260217_00

## Tools

### Create Contact

**Slug:** `EMAILOCTOPUS_CREATE_CONTACT`

This tool creates a new contact in EmailOctopus. The tool will add a contact to a specified list with the provided information.

### Create Field

**Slug:** `EMAILOCTOPUS_CREATE_FIELD`

Tool 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.

### Create List

**Slug:** `EMAILOCTOPUS_CREATE_LIST`

Creates 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.

### Create Tag

**Slug:** `EMAILOCTOPUS_CREATE_TAG`

Tool 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.

### Delete Contact

**Slug:** `EMAILOCTOPUS_DELETE_CONTACT`

Permanently 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).

### Delete Field

**Slug:** `EMAILOCTOPUS_DELETE_FIELD`

Permanently 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.

### Delete List

**Slug:** `EMAILOCTOPUS_DELETE_LIST`

This 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.

### Delete Tag

**Slug:** `EMAILOCTOPUS_DELETE_TAG`

Tool 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.

### Get All Lists

**Slug:** `EMAILOCTOPUS_GET_ALL_LISTS`

This tool retrieves all the mailing lists associated with the EmailOctopus account.

### Get Contact

**Slug:** `EMAILOCTOPUS_GET_CONTACT`

Tool 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.

### Get List

**Slug:** `EMAILOCTOPUS_GET_LIST`

Retrieves 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.

### Get Recent Campaigns

**Slug:** `EMAILOCTOPUS_GET_RECENT_CAMPAIGNS`

This tool retrieves a list of recent campaigns from the EmailOctopus account.

### List Contacts

**Slug:** `EMAILOCTOPUS_LIST_CONTACTS`

Tool to retrieve contacts from an EmailOctopus list. Returns a paginated list of contacts with optional filtering by tag, status, and date ranges.

### List Tags

**Slug:** `EMAILOCTOPUS_LIST_TAGS`

Tool 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.

### Unsubscribe Contact

**Slug:** `EMAILOCTOPUS_UNSUBSCRIBE_CONTACT`

Unsubscribes 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.

### Batch Update Contacts

**Slug:** `EMAILOCTOPUS_UPDATE_CONTACTS_BATCH`

Tool 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.

### Update Field

**Slug:** `EMAILOCTOPUS_UPDATE_FIELD`

Updates 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.

### Update List

**Slug:** `EMAILOCTOPUS_UPDATE_LIST`

Tool to update an existing mailing list's name in EmailOctopus. Use when you need to rename a list.

### Update Tag

**Slug:** `EMAILOCTOPUS_UPDATE_TAG`

Tool to update an existing tag on a mailing list. Use when you need to rename a tag.

### Create or Update Contact

**Slug:** `EMAILOCTOPUS_UPSERT_CONTACT`

Tool 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.
