# Enginemailer

Enginemailer is an email marketing platform that enables businesses to manage contacts, design campaigns, and send personalized emails.

- **Category:** email newsletters
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 38
- **Triggers:** 0
- **Slug:** `ENGINEMAILER`
- **Version:** 20260316_00

## Tools

### Activate Subscriber

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the subscriber to activate. Only applicable to subscribers that are deactivated either through the API or manually. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add or Update Subscriber

**Slug:** `ENGINEMAILER_ADD_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the subscriber to add or update. |
| `lastName` | string | No | Last name of the subscriber (optional). |
| `firstName` | string | No | First name of the subscriber (optional). |
| `customFields` | object | No | Custom fields for the subscriber as key-value pairs (optional). Examples include company, country, phone, etc. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Batch Update Status

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ID` | string | Yes | The batch job ID returned by the batch_update_subscribers operation. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Batch Update Subscribers

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subscribers` | array | Yes | Array of subscriber objects to add or update. Subscribers that do not pass validation will be removed from processing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Export Status V2

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ID` | integer | Yes | The Export ID received from the export initiation method |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Test API Connection

**Slug:** `ENGINEMAILER_CONNECT`

Tool to test API connection and verify authentication. Use when you need to validate API credentials or check connectivity.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Campaign

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `replyTo` | string | No | Reply-to email address; defaults to fromEmail if omitted |
| `fromName` | string | Yes | Sender's name as it will appear in the email |
| `sendDate` | string | Yes | Scheduled send date/time in 'YYYY-MM-DD HH:MM:SS' format |
| `toListID` | integer | Yes | ID of the recipient list |
| `fromEmail` | string | Yes | Valid sender email address |
| `trackOpens` | boolean | No | Enable open tracking |
| `attachments` | array | No | List of attachment URLs or base64-encoded file data |
| `trackClicks` | boolean | No | Enable click tracking |
| `campaignName` | string | Yes | Name of the campaign |
| `campaignText` | string | No | Plain-text content; auto-generated if omitted |
| `campaignContent` | string | Yes | HTML content of the email campaign |
| `campaignSubject` | string | Yes | Subject of the email campaign |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Campaign

**Slug:** `ENGINEMAILER_DELETE_CAMPAIGN`

Tool to delete an undelivered email campaign. Use when you need to remove a campaign that has not been sent yet.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `CampaignID` | string | Yes | The unique identifier of the undelivered campaign to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Recipient List

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `campaignid` | string | Yes | The unique identifier of the campaign from which to delete the recipient list. |
| `recipientlistid` | string | Yes | The unique identifier of the recipient list to delete from the campaign. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Subscriber

**Slug:** `ENGINEMAILER_DELETE_SUBSCRIBER`

Tool to remove a subscriber from the system by email address. Use when you need to permanently delete a subscriber's record.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the subscriber to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Export CSV Report V2

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `Period` | string | Yes | Date range for the report in 'DD MMM YYYY - DD MMM YYYY' format; max window of 60 days. |
| `DomainFilter` | string | No | Filter the export result by sender domain. |
| `EmailToFilter` | string | No | Filter the export result by a specific email address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Subscriber

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the subscriber to find. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Custom Field List

**Slug:** `ENGINEMAILER_GET_GETCUSTOMFIELD`

Tool to retrieve the list of custom fields configured for subscribers. Use when you need to discover available custom fields for subscriber management.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get List Campaign

**Slug:** `ENGINEMAILER_GET_LISTCAMPAIGN`

Tool to get a list of undelivered campaigns. Use when you need to fetch campaigns awaiting delivery.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get New Subscribers

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of records to return per request. Defaults to 50. |
| `source` | string | No | Filter subscribers by subscription source. |
| `filter_form` | integer | No | Filter results by specific form ID. |
| `filter_page` | integer | No | Filter results by specific page ID. |
| `filter_popup` | integer | No | Filter results by specific popup ID. |
| `lastpollingdate` | string | No | Retrieve only subscribers added after this timestamp for polling/sync workflows. Format should be ISO 8601 datetime string. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subcategories

**Slug:** `ENGINEMAILER_GET_SUBCATEGORY`

Tool to retrieve subcategories for a given category. Use when you need to list or choose subcategories after selecting a category.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `CategoryID` | integer | Yes | ID of the category to get subcategories for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscriber

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address of the subscriber to retrieve information for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscriber Autoresponder Completed

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of records to return. Defaults to 50. |
| `lastpollingdate` | string | No | Retrieve events after specified timestamp for polling. Use ISO 8601 format or timestamp string. |
| `filter_autoresponder` | integer | No | Filter results by specific autoresponder ID. If not provided, returns completions for all autoresponders. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscriber Autoresponder Triggered

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of records to return. Defaults to 50. Maximum allowed value is 50. |
| `lastpollingdate` | string | No | Retrieve events after specified timestamp for polling. Use format: YYYY-MM-DD HH:MM:SS (e.g., '2024-01-01 00:00:00'). |
| `filter_autoresponder` | integer | No | Filter results by specific autoresponder ID. If not provided, returns triggers for all autoresponders. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Deleted Subscribers

**Slug:** `ENGINEMAILER_GET_SUBSCRIBERS_DELETED`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of deleted subscriber records to return. Defaults to 50. |
| `lastpollingdate` | string | No | Date filter to retrieve only subscribers deleted after this timestamp. Format should match the API's expected date/time format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscribers Modified

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of records to return. Defaults to 50. |
| `lastpollingdate` | string | No | Retrieve only subscribers modified after this timestamp for polling/sync workflows. Format: 'YYYY-MM-DD HH:MM:SS' (without timezone). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscribers Tagged

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of records to return. Defaults to 50. |
| `lastpollingdate` | string | No | Retrieve only subscribers tagged after this timestamp for polling/sync workflows. Format must be 'YYYY-MM-DD HH:MM:SS' (e.g., '2024-01-01 00:00:00'). |
| `filter_subcategory` | integer | No | Filter results by specific subcategory (tag) ID. If not provided, returns tagged subscribers for all subcategories. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Untagged Subscribers

**Slug:** `ENGINEMAILER_GET_SUBSCRIBERS_UNTAGGED`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of subscriber records to return. Defaults to 50. |
| `lastpollingdate` | string | No | Retrieve only subscribers untagged after this timestamp for polling/sync workflows. Format should be ISO 8601 datetime string. |
| `filter_subcategory` | integer | No | Filter results by specific subcategory ID to see subscribers untagged from that subcategory. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Unsubscribe Events

**Slug:** `ENGINEMAILER_GET_UNSUBSCRIBE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of unsubscribe records to return. Defaults to 50. |
| `filter` | string | No | General filter criteria for unsubscribe events. |
| `filter_campaign` | integer | No | Filter results by specific campaign ID. Returns only unsubscribes related to that campaign. |
| `lastpollingdate` | string | No | Retrieve unsubscribe events after specified timestamp for polling. Use ISO 8601 format or timestamp string. |
| `filter_autoresponder` | integer | No | Filter results by specific autoresponder ID. Returns only unsubscribes related to that autoresponder. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Insert Subscriber

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the subscriber (optional). |
| `email` | string | Yes | Email address of the subscriber to add. |
| `listid` | string | No | Identifier of the mailing list to which the subscriber will be added (optional). Required in practice — omitting it causes failure even when a default list exists. |
| `customfields` | array | No | Custom fields for the subscriber as an array of objects with customfield_key and customfield_value (optional). Only predefined custom field keys are accepted. Unrecognized keys are silently ignored — no error is raised, and the data is dropped. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Autoresponders

**Slug:** `ENGINEMAILER_LIST_AUTORESPONDERS`

Tool to retrieve a list of all autoresponders. Use when you need to fetch available autoresponders configured in the system.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Campaigns

**Slug:** `ENGINEMAILER_LIST_CAMPAIGNS`

Tool to retrieve a list of all campaigns. Use when you need to fetch all campaigns from the system.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Forms

**Slug:** `ENGINEMAILER_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.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Pages

**Slug:** `ENGINEMAILER_LIST_PAGES`

Tool to retrieve a list of all pages. Use when you need to fetch available pages.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Popups

**Slug:** `ENGINEMAILER_LIST_POPUPS`

Tool to retrieve a list of popups from Enginemailer. Use when you need to fetch available popups for n8n workflows.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Templates

**Slug:** `ENGINEMAILER_LIST_TEMPLATES`

Tool to retrieve a list of all email templates. Use when you need to fetch available email templates for campaigns.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Pause Campaign

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `CampaignID` | string | Yes | The unique identifier of the campaign to pause. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create/Update Category

**Slug:** `ENGINEMAILER_POST_UPDATECATEGORY`

Tool to create or update a category for subscriber segmentation. Use when organizing subscribers by common interests for targeted email marketing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `categoryDesc` | string | Yes | Description of the category. |
| `categoryName` | string | Yes | Name of the category to create or update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Subscriber

**Slug:** `ENGINEMAILER_POST_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the subscriber to update. |
| `subcategory` | string | No | Subcategory assignment for the subscriber. Can be a single subcategory string or an array of subcategories (optional). |
| `customfields` | array | No | Array of custom field objects to update for this subscriber (optional). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Campaign

**Slug:** `ENGINEMAILER_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'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `CampaignID` | integer | Yes | Targeted Campaign ID to send immediately. Must be a positive integer. Ensure the campaign exists, is not scheduled/delivering/delivered, and has at least one recipient before calling this. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Tag Subscriber to Subcategory

**Slug:** `ENGINEMAILER_TAG_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address of the subscriber to tag to a subcategory. |
| `subcategoryId` | string | Yes | The unique identifier of the subcategory to which the subscriber will be tagged. Can be a string or integer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unsubscribe (N8N)

**Slug:** `ENGINEMAILER_UNSUBSCRIBE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address of the subscriber to unsubscribe. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Unsubscribe Subscriber

**Slug:** `ENGINEMAILER_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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address of the subscriber to unsubscribe. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |