# Enginemailer

```json
{
  "name": "Enginemailer",
  "slug": "enginemailer",
  "url": "https://composio.dev/toolkits/enginemailer",
  "markdown_url": "https://composio.dev/toolkits/enginemailer.md",
  "logo_url": "https://logos.composio.dev/api/enginemailer",
  "categories": [
    "marketing & social media"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-05-12T10:10:24.662Z"
}
```

![Enginemailer logo](https://logos.composio.dev/api/enginemailer)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Enginemailer MCP or direct API to send campaigns, manage contact lists, design email templates, and track engagement—using just natural language.

## Summary

Enginemailer is an email marketing platform for managing contacts, campaigns, and sending personalized emails. It helps businesses automate outreach and boost engagement with targeted messaging.

## Categories

- marketing & social media

## Toolkit Details

- Tools: 38

## Images

- Logo: https://logos.composio.dev/api/enginemailer

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Enginemailer.
  - Setup:
    - Configure Api Key credentials for Enginemailer.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Add new subscriber to newsletter list
- Pause tomorrow's scheduled marketing campaign
- Export email delivery report from last week
- Send draft campaign to all VIP contacts

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `ENGINEMAILER_ACTIVATE_SUBSCRIBER` | Activate Subscriber | Tool to activate an inactive subscriber in EngineMailer. Use when you need to reactivate a subscriber that was previously deactivated either through the API or manually. |
| `ENGINEMAILER_ADD_UPDATE_SUBSCRIBER` | Add or Update Subscriber | Tool to add or update a subscriber with custom fields via N8N integration. Use when you need to create a new subscriber or update an existing one in the EngineMailer system. |
| `ENGINEMAILER_BATCH_UPDATE_STATUS` | Check Batch Update Status | Tool to check the status of a batch subscriber update operation. Use when you need to verify if a batch update job has completed or is still processing. |
| `ENGINEMAILER_BATCH_UPDATE_SUBSCRIBERS` | Batch Update Subscribers | Tool to add or update multiple subscribers with custom fields in a single batch operation. Use when you need to create or update multiple subscribers efficiently. Subscribers that fail validation are removed from processing automatically. |
| `ENGINEMAILER_CHECK_EXPORT_STATUS_V2` | Check Export Status V2 | Tool to check status of a previously requested CSV report export. Use after initiating an export to poll for completion. Large exports may take significant time; poll repeatedly until status indicates readiness before consuming the export data. |
| `ENGINEMAILER_CONNECT` | Test API Connection | Tool to test API connection and verify authentication. Use when you need to validate API credentials or check connectivity. |
| `ENGINEMAILER_CREATE_CAMPAIGN` | Create Campaign | Tool to create a new email campaign. Use when you need to configure and schedule a campaign before sending. Set trackOpens and trackClicks at creation; these flags cannot retroactively affect already-delivered messages. |
| `ENGINEMAILER_DELETE_CAMPAIGN` | Delete Campaign | Tool to delete an undelivered email campaign. Use when you need to remove a campaign that has not been sent yet. |
| `ENGINEMAILER_DELETE_RECIPIENT_LIST` | Delete Recipient List | Tool to delete an existing recipient list from a targeted campaign. Use when you need to remove a specific recipient list from a campaign. |
| `ENGINEMAILER_DELETE_SUBSCRIBER` | Delete Subscriber | Tool to remove a subscriber from the system by email address. Use when you need to permanently delete a subscriber's record. |
| `ENGINEMAILER_EXPORT_CSV_REPORT_V2` | Export CSV Report V2 | Tool to export a transactional email report as CSV. Initiates an async export within a specific date range (max past 60 days); check readiness via ENGINEMAILER_CHECK_EXPORT_STATUS_V2 before using the export. |
| `ENGINEMAILER_FIND_SUBSCRIBER` | Find Subscriber | Tool to find a subscriber by email address via N8N integration. Use when you need to search for and retrieve subscriber information from the EngineMailer system. |
| `ENGINEMAILER_GET_GETCUSTOMFIELD` | Get Custom Field List | Tool to retrieve the list of custom fields configured for subscribers. Use when you need to discover available custom fields for subscriber management. |
| `ENGINEMAILER_GET_LISTCAMPAIGN` | Get List Campaign | Tool to get a list of undelivered campaigns. Use when you need to fetch campaigns awaiting delivery. |
| `ENGINEMAILER_GET_NEW_SUBSCRIBERS` | Get New Subscribers | Tool to retrieve new subscribers with optional filtering by source, form, page, or popup. Use when you need to fetch recently added subscribers for synchronization or reporting workflows. |
| `ENGINEMAILER_GET_SUBCATEGORY` | Get Subcategories | Tool to retrieve subcategories for a given category. Use when you need to list or choose subcategories after selecting a category. |
| `ENGINEMAILER_GET_SUBSCRIBER` | Get Subscriber | Tool to retrieve subscriber information by email address. Use when you need to fetch details about a specific subscriber including their custom fields. |
| `ENGINEMAILER_GET_SUBSCRIBER_AUTORESPONDER_COMPLETED` | Get Subscriber Autoresponder Completed | Tool to retrieve subscribers who completed autoresponders with optional filtering by autoresponder ID. Use when you need to fetch completion events for autoresponders, optionally filtered by specific autoresponder or polling for new events since a timestamp. |
| `ENGINEMAILER_GET_SUBSCRIBER_AUTORESPONDER_TRIGGERED` | Get Subscriber Autoresponder Triggered | Tool to retrieve subscribers who triggered autoresponders with optional filtering by autoresponder ID. Use when you need to fetch trigger events for autoresponders, optionally filtered by specific autoresponder or polling for new events since a timestamp. |
| `ENGINEMAILER_GET_SUBSCRIBERS_DELETED` | Get Deleted Subscribers | Tool to retrieve deleted subscribers since last polling date. Use when you need to track or sync subscribers who have been removed from the system. |
| `ENGINEMAILER_GET_SUBSCRIBERS_MODIFIED` | Get Subscribers Modified | Tool to retrieve modified subscribers since last polling date with optional limit. Use when you need to fetch recently modified subscribers for synchronization or polling workflows. |
| `ENGINEMAILER_GET_SUBSCRIBERS_TAGGED` | Get Subscribers Tagged | Tool to retrieve subscribers who were tagged with optional filtering by subcategory. Use when you need to fetch tagged subscribers for synchronization or reporting workflows. |
| `ENGINEMAILER_GET_SUBSCRIBERS_UNTAGGED` | Get Untagged Subscribers | Tool to retrieve subscribers who were untagged from subcategories. Use when you need to track or sync subscribers who have had tags removed, with optional filtering by subcategory and polling date. |
| `ENGINEMAILER_GET_UNSUBSCRIBE` | Get Unsubscribe Events | Tool to retrieve unsubscribe events with optional filtering by campaign or autoresponder. Use when you need to fetch unsubscribe data for reporting, synchronization, or compliance workflows. |
| `ENGINEMAILER_INSERT_SUBSCRIBER` | Insert Subscriber | Tool to add a new subscriber with optional custom fields. Use when registering a user to a specific mailing list after verifying their email. |
| `ENGINEMAILER_LIST_AUTORESPONDERS` | List Autoresponders | Tool to retrieve a list of all autoresponders. Use when you need to fetch available autoresponders configured in the system. |
| `ENGINEMAILER_LIST_CAMPAIGNS` | List Campaigns | Tool to retrieve a list of all campaigns. Use when you need to fetch all campaigns from the system. |
| `ENGINEMAILER_LIST_FORMS` | List Forms | Tool to retrieve a list of available forms in Enginemailer. Use when you need to discover forms for n8n integration or workflow configuration. |
| `ENGINEMAILER_LIST_PAGES` | List Pages | Tool to retrieve a list of all pages. Use when you need to fetch available pages. |
| `ENGINEMAILER_LIST_POPUPS` | List Popups | Tool to retrieve a list of popups from Enginemailer. Use when you need to fetch available popups for n8n workflows. |
| `ENGINEMAILER_LIST_TEMPLATES` | List Templates | Tool to retrieve a list of all email templates. Use when you need to fetch available email templates for campaigns. |
| `ENGINEMAILER_PAUSE_CAMPAIGN` | Pause Campaign | Tool to pause a scheduled email campaign. Use when you need to halt a campaign before sending to apply updates or adjust schedule. |
| `ENGINEMAILER_POST_UPDATECATEGORY` | Create/Update Category | Tool to create or update a category for subscriber segmentation. Use when organizing subscribers by common interests for targeted email marketing. |
| `ENGINEMAILER_POST_UPDATE_SUBSCRIBER` | Update Subscriber | Tool to update data for an existing subscriber in EngineMailer. Use when you need to modify subscriber information such as custom fields or subcategory assignments. |
| `ENGINEMAILER_SEND_CAMPAIGN` | Send Campaign | Tool to send an email campaign immediately. Use when the campaign exists, has at least one recipient, and is not scheduled or already delivered. E.g., 'Send campaign 123 now'. |
| `ENGINEMAILER_TAG_TO_SUBCATEGORY` | Tag Subscriber to Subcategory | Tool to tag a subscriber to a specific subcategory via N8N API endpoint. Use when you need to categorize or organize subscribers by assigning them to a subcategory. |
| `ENGINEMAILER_UNSUBSCRIBE` | Unsubscribe (N8N) | Tool to unsubscribe a subscriber via N8N API endpoint. Use when you need to remove a subscriber from the mailing list using the N8N integration endpoint. |
| `ENGINEMAILER_UNSUBSCRIBE_SUBSCRIBER` | Unsubscribe Subscriber | Tool to unsubscribe a subscriber from the email list. Use when a user requests to be removed from the mailing list or to comply with unsubscribe requests. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Enginemailer Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Enginemailer actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Create a new campaign for the spring sale newsletter and schedule it for next Monday at 10am.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Create a new campaign for the spring sale newsletter and schedule it for next Monday at 10am.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and Claude Agent SDK
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Create Tool Router Session

Initialize the Composio client and create a Tool Router session
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });

console.log("Creating Tool Router session...");
const { mcp } = await composio.create('your-user-id');
console.log(`Tool Router session created: ${mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Enginemailer tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Create a new Enginemailer campaign for the June newsletter')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText, stepCountIs } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});

const tools = await client.tools();

const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{ role: 'user', content: 'Create a new Enginemailer campaign for the June newsletter' }],
  stopWhen: stepCountIs(5)
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Enginemailer Integration

- Supports both Enginemailer MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Enginemailer data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Enginemailer access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Enginemailer
- Scoped, least privilege access to Enginemailer resources
- Full audit trail of agent actions to support review and compliance

## Use Enginemailer with any AI Agent Framework

Choose a framework you want to connect Enginemailer with:

- [OpenAI Agents SDK](https://composio.dev/toolkits/enginemailer/framework/open-ai-agents-sdk)
- [Claude Agent SDK](https://composio.dev/toolkits/enginemailer/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/enginemailer/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/enginemailer/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/enginemailer/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/enginemailer/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/enginemailer/framework/hermes-agent)
- [Google ADK](https://composio.dev/toolkits/enginemailer/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/enginemailer/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/enginemailer/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/enginemailer/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/enginemailer/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/enginemailer/framework/crew-ai)
- [Pydantic AI](https://composio.dev/toolkits/enginemailer/framework/pydantic-ai)
- [AutoGen](https://composio.dev/toolkits/enginemailer/framework/autogen)

## Related Toolkits

- [Reddit](https://composio.dev/toolkits/reddit) - Reddit is a social news platform with thriving user-driven communities (subreddits). It's the go-to place for discussion, content sharing, and viral marketing.
- [Facebook](https://composio.dev/toolkits/facebook) - Facebook is a social media and advertising platform for businesses and creators. It helps you connect, share, and manage content across your public Facebook Pages.
- [Linkedin](https://composio.dev/toolkits/linkedin) - LinkedIn is a professional networking platform for connecting, sharing content, and engaging with business opportunities. It's the go-to place for building your professional brand and unlocking new career connections.
- [Active campaign](https://composio.dev/toolkits/active_campaign) - ActiveCampaign is a marketing automation and CRM platform for managing email campaigns, sales pipelines, and customer segmentation. It helps businesses engage customers and drive growth through smart automation and targeted outreach.
- [ActiveTrail](https://composio.dev/toolkits/active_trail) - ActiveTrail is a user-friendly email marketing and automation platform. It helps you reach subscribers and automate campaigns with ease.
- [Ahrefs](https://composio.dev/toolkits/ahrefs) - Ahrefs is an SEO and marketing platform for site audits, keyword research, and competitor insights. It helps you improve search rankings and drive organic traffic.
- [Amcards](https://composio.dev/toolkits/amcards) - AMCards lets you create and mail personalized greeting cards online. Build stronger customer relationships with easy, automated card campaigns.
- [Beamer](https://composio.dev/toolkits/beamer) - Beamer is a news and changelog platform for in-app announcements and feature updates. It helps companies boost user engagement by sharing news where users are most active.
- [Benchmark email](https://composio.dev/toolkits/benchmark_email) - Benchmark Email is a platform for creating, sending, and tracking email campaigns. It's built to help you engage audiences and analyze results—all in one place.
- [Bigmailer](https://composio.dev/toolkits/bigmailer) - BigMailer is an email marketing platform for managing multiple brands with white-labeling and automation. It helps teams streamline campaigns and simplify integration with Amazon SES.
- [Brandfetch](https://composio.dev/toolkits/brandfetch) - Brandfetch is an API that delivers company logos, colors, and visual branding assets. It helps marketers and developers keep brand visuals consistent everywhere.
- [Brevo](https://composio.dev/toolkits/brevo) - Brevo is an all-in-one email and SMS marketing platform for transactional messaging, automation, and CRM. It helps businesses engage customers and streamline communications through powerful campaign tools.
- [Campayn](https://composio.dev/toolkits/campayn) - Campayn is an email marketing platform for creating, sending, and managing campaigns. It helps businesses engage contacts and grow audiences with easy-to-use tools.
- [Cardly](https://composio.dev/toolkits/cardly) - Cardly is a platform for creating and sending personalized direct mail to customers. It helps businesses break through the digital clutter by getting real engagement via physical mailboxes.
- [ClickSend](https://composio.dev/toolkits/clicksend) - ClickSend is a cloud-based SMS and email marketing platform for businesses. It streamlines communication by enabling quick message delivery and contact management.
- [Crustdata](https://composio.dev/toolkits/crustdata) - CrustData is an AI-powered data intelligence platform for real-time company and people data. It helps B2B sales teams, AI SDRs, and investors react to live business signals.
- [Curated](https://composio.dev/toolkits/curated) - Curated is a platform for collecting, curating, and publishing newsletters. It streamlines content aggregation and distribution for creators and teams.
- [Customerio](https://composio.dev/toolkits/customerio) - Customer.io is a customer engagement platform for targeted messaging across email, SMS, and push. Easily automate, segment, and track communications with your audience.
- [Cutt ly](https://composio.dev/toolkits/cutt_ly) - Cutt.ly is a URL shortening service for managing and analyzing links. Streamline your workflows with quick, trackable, and branded short URLs.
- [Demio](https://composio.dev/toolkits/demio) - Demio is webinar software built for marketers, offering both live and automated sessions with interactive features. It helps teams engage audiences and optimize lead generation through detailed analytics.

## Frequently Asked Questions

### Do I need my own developer credentials to use Enginemailer with Composio?

Yes, Enginemailer requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)