> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to EmailOctopus

The EmailOctopus connector lets your AI agent act in each user's EmailOctopus account. Each user connects their own EmailOctopus access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 25 tools.

**Authentication:** Bearer Token
**Categories:** Marketing
**Tools:** 25: 10 read, 11 write, 4 destructive
**Users sign in with:** Access token
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=EMAILOCTOPUS)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the EmailOctopus connection

   In **AgentKit > Connections**, create an EmailOctopus connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'emailoctopus'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize EmailOctopus:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'emailoctopus_campaigns_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "emailoctopus"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize EmailOctopus:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="emailoctopus_campaigns_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their EmailOctopus credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'emailoctopus_campaign_get',
  toolInput: {
    campaign_id: '<campaign_id>',
  },
  connector: 'emailoctopus',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="emailoctopus_campaign_get",
    tool_input={
        "campaign_id": "<campaign_id>",
    },
    connection_name="emailoctopus",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `emailoctopus_campaign_get`

Get Campaign · Read-only

Get one EmailOctopus campaign by ID.
Returns its name, subject, from address, content, status, target lists and sent_at.
Use Get Campaign Summary Report for its results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Find it with List Campaigns. Example: 9a8b7c6d-5e4f-11ef-9a1b-2c3d4e5f6a7b.

Example input: `{"campaign_id":"<campaign_id>"}`

### `emailoctopus_campaign_report_contacts_list`

Get Campaign Contact Report · Read-only

List the contacts in one result group of a sent EmailOctopus campaign, such as those who opened or bounced.
Returns a page of contacts with id, email_address and the event time.
The status input picks the group.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Find it with List Campaigns. Example: 9a8b7c6d-5e4f-11ef-9a1b-2c3d4e5f6a7b.
- `status` (`string`, required): Which contacts to return: bounced, clicked, complained, opened, sent, unsubscribed or not-opened. Example: opened. One of: `bounced`, `clicked`, `complained`, `opened`, `sent`, `unsubscribed`, `not-opened`, `not-clicked`.
- `limit` (`integer`, optional): Maximum number of results per page, up to 100. Example: 100.
- `starting_after` (`string`, optional): Cursor for the next page: the value of paging.next.starting_after from the previous response. Example: WyIyMDI0LTEyLTA3VDE1OjAzOjAxKzAwOjAwIiwiNDYzN2RmYTAtYjZmMC0xMWVmLWFjZDYtZjU5YjA4MDFlMjBkIl0.

Example input: `{"campaign_id":"<campaign_id>","status":"bounced"}`

### `emailoctopus_campaign_report_links_get`

Get Campaign Links Report · Read-only

Get the per-link click results of a sent EmailOctopus campaign.
Returns each link URL with its total and unique clicks.
Use Get Campaign Summary Report for overall totals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Find it with List Campaigns. Example: 9a8b7c6d-5e4f-11ef-9a1b-2c3d4e5f6a7b.

Example input: `{"campaign_id":"<campaign_id>"}`

### `emailoctopus_campaign_report_summary_get`

Get Campaign Summary Report · Read-only

Get the summary results of a sent EmailOctopus campaign.
Returns totals and unique counts for sent, opened, clicked, bounced, complained and unsubscribed.
Use Get Campaign Contact Report for the contacts behind a number.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `campaign_id` (`string`, required): ID of the campaign. Find it with List Campaigns. Example: 9a8b7c6d-5e4f-11ef-9a1b-2c3d4e5f6a7b.

Example input: `{"campaign_id":"<campaign_id>"}`

### `emailoctopus_campaigns_list`

List Campaigns · Read-only

List the email campaigns in the EmailOctopus account, a page at a time.
Returns each campaign's id, name, subject, status, sent_at and lists, plus a paging cursor.
Use Get Campaign for content, or the report tools for results.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results per page, up to 100. Example: 100.
- `starting_after` (`string`, optional): Cursor for the next page: the value of paging.next.starting_after from the previous response. Example: WyIyMDI0LTEyLTA3VDE1OjAzOjAxKzAwOjAwIiwiNDYzN2RmYTAtYjZmMC0xMWVmLWFjZDYtZjU5YjA4MDFlMjBkIl0.

Example input: `{}`

### `emailoctopus_contact_get`

Get Contact · Read-only

Get one contact on an EmailOctopus list, by contact ID or by the MD5 hash of the lowercased email address.
Returns the contact's email_address, fields, tags, status and dates.
Use List Contacts to browse a list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID of the contact, or the MD5 hash of the contact's lowercased email address. Find it with List Contacts. Example: 6f1c2a8b-5d3e-11ef-8a1b-2c3d4e5f6a7b.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.

Example input: `{"contact_id":"<contact_id>","list_id":"<list_id>"}`

### `emailoctopus_contacts_list`

List Contacts · Read-only

List contacts on an EmailOctopus list, filtered by tag, status or created/updated dates.
Returns each contact's id, email_address, fields, tags, status and dates, plus a paging cursor.
Use Get Contact for one contact by ID or email hash.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `created_at_gte` (`string`, optional): Filter by creation date - greater than or equal to. ISO 8601 date format. Example: 2026-01-01T00:00:00Z.
- `created_at_lte` (`string`, optional): Filter by creation date - less than or equal to. ISO 8601 date format. Example: 2026-01-31T23:59:59Z.
- `last_updated_at_gte` (`string`, optional): Filter by update date - greater than or equal to. ISO 8601 date format. Example: 2026-01-01T00:00:00Z.
- `last_updated_at_lte` (`string`, optional): Filter by update date - less than or equal to. ISO 8601 date format. Example: 2026-01-31T23:59:59Z.
- `limit` (`integer`, optional): Maximum number of results per page, up to 100. Example: 100.
- `starting_after` (`string`, optional): Cursor for the next page: the value of paging.next.starting_after from the previous response. Example: WyIyMDI0LTEyLTA3VDE1OjAzOjAxKzAwOjAwIiwiNDYzN2RmYTAtYjZmMC0xMWVmLWFjZDYtZjU5YjA4MDFlMjBkIl0.
- `status` (`string`, optional): The status of the contact. Example: subscribed. One of: `subscribed`, `unsubscribed`, `pending`.
- `tag` (`string`, optional): The tag associated with the contact. Example: vip.

Example input: `{"list_id":"<list_id>"}`

### `emailoctopus_list_get`

Get List · Read-only

Get one EmailOctopus list by ID.
Returns its name, custom fields (with their tags and types), tags and subscriber counts.
Use this to learn a list's field tags before creating contacts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.

Example input: `{"list_id":"<list_id>"}`

### `emailoctopus_list_tags_list`

List Tags · Read-only

List the tags defined on an EmailOctopus list.
Returns each tag's name, a page at a time.
Use these names in a contact's tags or the List Contacts tag filter.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `limit` (`integer`, optional): Maximum number of results per page, up to 100. Example: 100.
- `starting_after` (`string`, optional): Cursor for the next page: the value of paging.next.starting_after from the previous response. Example: WyIyMDI0LTEyLTA3VDE1OjAzOjAxKzAwOjAwIiwiNDYzN2RmYTAtYjZmMC0xMWVmLWFjZDYtZjU5YjA4MDFlMjBkIl0.

Example input: `{"list_id":"<list_id>"}`

### `emailoctopus_lists_list`

List Lists · Read-only

List the mailing lists in the EmailOctopus account, a page at a time.
Returns each list's id, name, fields, tags, contact counts and created_at, plus a paging cursor.
Use this to find a list ID. Use Get List for one list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Maximum number of results per page, up to 100. Example: 100.
- `starting_after` (`string`, optional): Cursor for the next page: the value of paging.next.starting_after from the previous response. Example: WyIyMDI0LTEyLTA3VDE1OjAzOjAxKzAwOjAwIiwiNDYzN2RmYTAtYjZmMC0xMWVmLWFjZDYtZjU5YjA4MDFlMjBkIl0.

Example input: `{}`

### `emailoctopus_automation_contact_start`

Start Automation For Contact · Write

Start an EmailOctopus automation for one contact, as if its trigger had fired.
Returns an empty success response; 409 if the contact is already in it.
The automation must use the "started via API" trigger and the contact must be on the automation's list.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `automation_id` (`string`, required): ID of the automation, from its URL in the EmailOctopus dashboard. Example: 1b2c3d4e-5f6a-11ef-8b7c-9d0e1f2a3b4c.
- `contact_id` (`string`, required): ID of the contact to start the automation for, from List Contacts. Example: 6f1c2a8b-5d3e-11ef-8a1b-2c3d4e5f6a7b.

Example input: `{"automation_id":"<automation_id>","contact_id":"<contact_id>"}`

### `emailoctopus_contact_create`

Create Contact · Write

Add a new contact to an EmailOctopus list.
Returns the new contact with its id; fails with 409 if the email is already on the list.
Use Create Or Update Contact to upsert by email instead.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `email_address` (`string`, required): The email address of the contact. Example: otto@example.com.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `fields` (`object`, optional): Custom field values as an object keyed by each field's tag (see List Fields in Get List), e.g. FirstName. Values are text, numbers, dates (YYYY-MM-DD) or choices. Example: {"FirstName": "Otto"}.
- `status` (`string`, optional): Subscription status. pending sends a double opt-in confirmation email if the list has one. Example: subscribed. One of: `pending`, `subscribed`, `unsubscribed`.
- `tags` (`array`, optional): Tag names to apply to the new contact. Example: ["vip"].

Example input: `{"email_address":"<email_address>","list_id":"<list_id>"}`

### `emailoctopus_contact_update`

Update Contact · Write

Update a contact's email address, field values, tags or status on an EmailOctopus list.
Returns the updated contact.
Only the fields you send change; tags are added or removed per key.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID of the contact, or the MD5 hash of the contact's lowercased email address. Find it with List Contacts. Example: 6f1c2a8b-5d3e-11ef-8a1b-2c3d4e5f6a7b.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `email_address` (`string`, optional): The email address of the contact. Example: otto@example.com.
- `fields` (`object`, optional): Custom field values as an object keyed by each field's tag (see List Fields in Get List), e.g. FirstName. Values are text, numbers, dates (YYYY-MM-DD) or choices. Example: {"FirstName": "Otto"}.
- `status` (`string`, optional): The status of the contact. Example: unsubscribed. One of: `pending`, `subscribed`, `unsubscribed`.
- `tags` (`object`, optional): Tags to add or remove: an object whose keys are tag names and whose values are true to add the tag or false to remove it. Tags not mentioned are left unchanged. Example: {"vip": true, "trial": false}.

Example input: `{"contact_id":"<contact_id>","list_id":"<list_id>"}`

### `emailoctopus_contact_upsert`

Create Or Update Contact · Write

Create a contact on an EmailOctopus list, or update it if the email address is already there.
Returns the created or updated contact.
Use Create Contact to fail on duplicates instead.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `email_address` (`string`, required): The email address of the contact. Example: otto@example.com.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `fields` (`object`, optional): Custom field values as an object keyed by each field's tag (see List Fields in Get List), e.g. FirstName. Values are text, numbers, dates (YYYY-MM-DD) or choices. Example: {"FirstName": "Otto"}.
- `status` (`string`, optional): The status of the contact. Example: subscribed. One of: `pending`, `subscribed`, `unsubscribed`.
- `tags` (`object`, optional): Tags to add or remove: an object whose keys are tag names and whose values are true to add the tag or false to remove it. Tags not mentioned are left unchanged. Example: {"vip": true, "trial": false}.

Example input: `{"email_address":"<email_address>","list_id":"<list_id>"}`

### `emailoctopus_contacts_batch_update`

Update Contacts In Bulk · Write

Update up to 100 contacts on an EmailOctopus list in one call.
Returns the per-contact results, including any errors.
Each item needs the contact id plus the email_address, fields, tags or status to change.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `contacts` (`array`, required): Contacts to update, up to 100. Each item has the contact id (or MD5 hash of the lowercased email) and any of email_address, fields (object keyed by field tag), tags (object of tag name to true/false) and status. Example: [{"id": "6f1c2a8b-5d3e-11ef-8a1b-2c3d4e5f6a7b", "tags": {"vip": true}, "status": "subscribed"}].
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.

Example input: `{"contacts":[{"id":"6f1c2a8b-5d3e-11ef-8a1b-2c3d4e5f6a7b","tags":{"vip":true},"status":"subscribed"}],"list_id":"<list_id>"}`

### `emailoctopus_list_create`

Create List · Write

Create a new mailing list in EmailOctopus.
Returns the new list with its id.
Add custom fields with Create Field and contacts with Create Contact.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): The name of the list. Example: Newsletter subscribers.

Example input: `{"name":"<name>"}`

### `emailoctopus_list_field_create`

Create Field · Write

Add a custom field to an EmailOctopus list.
Returns the new field with its label, tag, type and fallback.
Choice fields need choices. Use the field's tag as the key in a contact's fields.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `label` (`string`, required): A human readable label for the field. Example: What is your hometown?.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `tag` (`string`, required): The ID used to reference the field in your emails. Example: Hometown.
- `type` (`string`, required): Field type: text, number, date, choice_single (one of the choices) or choice_multiple (several choices). Example: text. One of: `text`, `number`, `date`, `choice_single`, `choice_multiple`.
- `choices` (`array`, optional): The allowed values. Required when type is choice_single or choice_multiple; omit otherwise. Example: ["One", "Two"].
- `fallback` (`string`, optional): A default value for the field, used in campaigns when there is no other value available. Example: Unknown.

Example input: `{"label":"<label>","list_id":"<list_id>","tag":"<tag>","type":"text"}`

### `emailoctopus_list_field_update`

Update Field · Write

Update a custom field's label, tag or fallback on an EmailOctopus list.
Returns the updated field.
The field's type cannot change; send its current type.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `field_tag` (`string`, required): The current tag of the field to update, as listed in Get List. Example: Hometown.
- `label` (`string`, required): A human readable label for the field. Example: Home town.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `tag` (`string`, required): The field's tag after the update; send the current tag to keep it. Example: HomeTown.
- `type` (`string`, required): The type of the field. Example: text. One of: `text`, `number`, `date`.
- `fallback` (`string`, optional): A default value for the field, used in campaigns when there is no other value available. Example: Unknown.

Example input: `{"field_tag":"<field_tag>","label":"<label>","list_id":"<list_id>","tag":"<tag>","type":"text"}`

### `emailoctopus_list_tag_create`

Create Tag · Write

Create a tag on an EmailOctopus list.
Returns the new tag.
Apply it to contacts with Update Contact.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `tag` (`string`, required): Name of the tag to create. Example: vip.

Example input: `{"list_id":"<list_id>","tag":"<tag>"}`

### `emailoctopus_list_tag_update`

Rename Tag · Write

Rename a tag on an EmailOctopus list; contacts keep it under the new name.
Returns the updated tag.
Use List Tags to find the current name.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `current_tag` (`string`, required): Current name of the tag to rename. Example: vip.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `new_tag` (`string`, required): New name for the tag. Example: premium.

Example input: `{"current_tag":"<current_tag>","list_id":"<list_id>","new_tag":"<new_tag>"}`

### `emailoctopus_list_update`

Rename List · Write

Rename an EmailOctopus list.
Returns the updated list.
Use List Lists to find the list ID.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `name` (`string`, required): The name of the list. Example: Monthly newsletter.

Example input: `{"list_id":"<list_id>","name":"<name>"}`

### `emailoctopus_contact_delete`

Delete Contact · Destructive

Delete a contact from an EmailOctopus list.
Returns an empty success response.
To stop emails but keep the record, use Update Contact with status unsubscribed.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `contact_id` (`string`, required): ID of the contact, or the MD5 hash of the contact's lowercased email address. Find it with List Contacts. Example: 6f1c2a8b-5d3e-11ef-8a1b-2c3d4e5f6a7b.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.

Example input: `{"contact_id":"<contact_id>","list_id":"<list_id>"}`

### `emailoctopus_list_delete`

Delete List · Destructive

Delete an EmailOctopus list and all its contacts.
Returns an empty success response.
This cannot be undone.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.

Example input: `{"list_id":"<list_id>"}`

### `emailoctopus_list_field_delete`

Delete Field · Destructive

Delete a custom field from an EmailOctopus list, with its values on every contact.
Returns an empty success response.
Use Get List to find the field's tag.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `field_tag` (`string`, required): The tag of the field to delete, as listed in Get List. Example: Hometown.
- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.

Example input: `{"field_tag":"<field_tag>","list_id":"<list_id>"}`

### `emailoctopus_list_tag_delete`

Delete Tag · Destructive

Delete a tag from an EmailOctopus list and remove it from every contact.
Returns an empty success response.
Use List Tags to find the name.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `list_id` (`string`, required): ID of the EmailOctopus list. Find it with List Lists. Example: 4637dfa0-b6f0-11ef-acd6-f59b0801e20d.
- `tag` (`string`, required): Name of the tag to delete. Example: vip.

Example input: `{"list_id":"<list_id>","tag":"<tag>"}`

## Related

Other Marketing connectors ([all 190](/agentkit/connectors/?category=marketing)):

- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Mailchimp](/agentkit/connectors/mailchimp/): Scalekit connector, OAuth, 73 tools
- [Twitter / X](/agentkit/connectors/twitteroauth/): Scalekit connector, OAuth, 92 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
