The Enginemailer connector lets your AI agent act in each user's Enginemailer account. Each user connects their own Enginemailer API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 26 tools.
- Tools
- 26
- What they doRead · write · destructive
- 9 · 14 · 39 read14 write3 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Enginemailer connection
In AgentKit > Connections, create an Enginemailer connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'enginemailer'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Enginemailer:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'enginemailer_campaign_categories_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "enginemailer"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Enginemailer:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="enginemailer_campaign_categories_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Enginemailer credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolenginemailer_campaign_categories_listList the subscriber categories available for campaign targeting.Read-onlyList Campaign Categories
List the subscriber categories available for campaign targeting. Returns categories with ID and name. Use List Campaign Subcategories for a category's subcategories.
Inputs
This tool takes no inputs.
enginemailer_campaign_delivery_status_getGet delivery and engagement stats for a delivered campaign.Read-onlyGet Campaign Delivery Status
Get delivery and engagement stats for a delivered campaign. Returns emails sent, delivered, bounces, opens, unique opens, clicks, unique clicks, unsubscribes and spam complaints. Only campaigns with status Delivered are eligible.
Inputs
campaign_idintegerrequired- Enginemailer campaign ID, from List Campaigns or Create Campaign. Example: 1234.
enginemailer_campaign_subcategories_listList the subcategories in one category, for campaign targeting.Read-onlyList Campaign Subcategories
List the subcategories in one category, for campaign targeting. Returns subcategories with ID and name. Use the IDs in Assign Recipient List.
Inputs
category_idintegerrequired- Category ID, from List Campaign Categories. Example: 1.
enginemailer_campaigns_listList the account's undelivered campaigns.Read-onlyList Campaigns
List the account's undelivered campaigns. Returns the undelivered campaigns with their IDs and details. Use Get Campaign Delivery Status for delivered campaigns' stats.
Inputs
This tool takes no inputs.
enginemailer_custom_fields_listList the subscriber custom fields defined in the account.Read-onlyList Custom Fields
List the subscriber custom fields defined in the account. Returns each field with its key and type. Use the field keys in Insert Subscriber or Update Subscriber.
Inputs
This tool takes no inputs.
enginemailer_subcategories_getList the subscriber categories and their subcategories (lists).Read-onlyGet Subcategories
List the subscriber categories and their subcategories (lists). Returns the categories with their subcategory IDs and names. Use the subcategory IDs in Insert Subscriber or Update Subscriber.
Inputs
include_active_subscriber_countboolean- Include each subcategory's active subscriber count (whitelisted accounts only). Example: true.
enginemailer_subscriber_getGet one subscriber by email address.Read-onlyGet Subscriber
Get one subscriber by email address. Returns the subscriber ID, status and custom field values. Use Insert Subscriber to add a new one.
Inputs
emailstringrequired- The subscriber's email address. Example: jane@example.com.
enginemailer_subscribers_batch_update_statusGet the status of a Batch Update Subscribers job.Read-onlyGet Batch Update Status
Get the status of a Batch Update Subscribers job. Returns the job's status. Use Batch Update Subscribers to start a job.
Inputs
import_idintegerrequired- ImportID returned by Batch Update Subscribers. Example: 1234.
enginemailer_transactional_report_export_statusCheck a transactional report export.Read-onlyGet Transactional Export Status
Check a transactional report export. Returns its status (Processing or Complete) and, when complete, the CSV download URL. Use Export Transactional Report first.
Inputs
export_idintegerrequired- ExportID returned by Export Transactional Report. Example: 9.
enginemailer_campaign_createCreate an email campaign with sender, subject and HTML content (paid accounts; 200 campaigns at most).WriteCreate Campaign
Create an email campaign with sender, subject and HTML content (paid accounts; 200 campaigns at most). Returns the result with the new campaign's ID. Then use Assign Recipient List and Send Campaign or Schedule Campaign.
Inputs
campaign_namestringrequired- Campaign name, up to 128 characters. Example: November newsletter.
contentstringrequired- HTML content of the campaign, up to 256 KB. Example: <h1>Hello</h1><p>Our November news.</p>.
sender_emailstringrequired- Sender email. Its domain must be verified in the Enginemailer account. Example: news@acme.com.
sender_namestringrequired- Sender name, up to 128 characters. Example: Acme Support.
subjectstringrequired- Email subject, up to 256 characters. Example: What's new in November.
reply_tostring- Reply-to email address. Example: support@acme.com.
enginemailer_campaign_pausePause a scheduled campaign that has not started delivering.WritePause Campaign
Pause a scheduled campaign that has not started delivering. Returns a status result. Use Schedule Campaign to reschedule it.
- Idempotent
Inputs
campaign_idintegerrequired- Enginemailer campaign ID, from List Campaigns or Create Campaign. Example: 1234.
enginemailer_campaign_recipient_list_assignSet a campaign's recipients: all subscribers, or those in given subcategories.WriteAssign Recipient List
Set a campaign's recipients: all subscribers, or those in given subcategories. Returns a status result. Use List Campaign Subcategories for IDs. Not allowed on scheduled or delivered campaigns.
Inputs
campaign_idintegerrequired- ID of the campaign. Example: 1234.
filter_byintegerrequired- 1 assigns all subscribers; 2 filters by subcategories. Example: 2.one of
12 category_listarray- Subcategory IDs to filter by (from List Campaign Subcategories). Required when filter_by is 2. Example: [1, 2].
filter_typestring- AND sends to subscribers in all listed subcategories; OR to subscribers in any. Required when filter_by is 2. Example: OR.one of
ANDOR
enginemailer_campaign_scheduleSchedule a campaign to send at a future time on a 15-minute boundary.WriteSchedule Campaign
Schedule a campaign to send at a future time on a 15-minute boundary. Returns a status result. Insufficient credit marks it failed at send time. Use Pause Campaign to stop a scheduled send.
Inputs
campaign_idintegerrequired- Enginemailer campaign ID, from List Campaigns or Create Campaign. Example: 1234.
schedule_timestringrequired- Send time as ddMMyyyy hh:mmtt, on a 15-minute boundary, in the future. Example: 01122026 12:15PM.
enginemailer_campaign_sendSend a campaign now to its recipient list.WriteSend Campaign
Send a campaign now to its recipient list. It needs at least one recipient. Returns a status result. Emails go out to every recipient. Use Schedule Campaign to send later.
Inputs
campaign_idintegerrequired- Enginemailer campaign ID, from List Campaigns or Create Campaign. Example: 1234.
enginemailer_campaign_updateUpdate an undelivered campaign's name, sender, subject or content.WriteUpdate Campaign
Update an undelivered campaign's name, sender, subject or content. Returns a status result. Use List Campaigns to find the ID.
- Idempotent
Inputs
campaign_idintegerrequired- ID of the campaign to update. Example: 1234.
campaign_namestringrequired- Campaign name, up to 128 characters. Example: November newsletter.
contentstringrequired- HTML content of the campaign, up to 256 KB. Example: <h1>Hello</h1><p>Our November news.</p>.
sender_emailstringrequired- Sender email. Its domain must be verified in the Enginemailer account. Example: news@acme.com.
sender_namestringrequired- Sender name, up to 128 characters. Example: Acme Support.
subjectstringrequired- Email subject, up to 256 characters. Example: What's new in November.
reply_tostring- Reply-to email address. Example: support@acme.com.
enginemailer_category_saveCreate a subscriber category, or rename an existing one, and create or rename its subcategories.WriteCreate or Update Category
Create a subscriber category, or rename an existing one, and create or rename its subcategories. Returns a status result. Use Get Subcategories to see existing IDs.
Inputs
category_idintegerrequired- Category ID to update, or 0 to create a new category. Example: 0.
category_namestringrequired- Category name, up to 128 characters. Renames an existing category. Example: Festivals.
descriptionstring- Category description, up to 128 characters. Example: Festive season lists.
isvisibleboolean- Whether the category is visible. Defaults to true. Example: true.
subcategoriesarray- Subcategories to create or rename. Each has subcategoryID (0 for new), subcategoryName and an optional description. Example: [{"subcategoryID": 0, "subcategoryName": "New Year"}].
enginemailer_subscriber_activateReactivate a subscriber that was deactivated through the API or the portal.WriteActivate Subscriber
Reactivate a subscriber that was deactivated through the API or the portal. Returns a status result. Use Get Subscriber to check the status.
- Idempotent
Inputs
emailstringrequired- The subscriber's email address. Example: jane@example.com.
enginemailer_subscriber_insertAdd a subscriber with optional subcategories and custom fields.WriteInsert Subscriber
Add a subscriber with optional subcategories and custom fields. Returns a status result. Free accounts can add 50 a day and paid accounts 10,000. Use Batch Update Subscribers for many at once.
Inputs
emailstringrequired- Subscriber email address. Example: jane@example.com.
customfieldsarray- Custom field values. Each item has customfield_key (the field's FieldKey from List Custom Fields) and customfield_value, in the field's format: dates as dd MMM yyyy, phones with + and country code, multiple choices joined with |. Example: [{"customfield_key": "first_name", "customfield_value": "Jane"}].
sourcetypestring- Label for where the subscriber came from. Example: Website signup.
subcategoriesarray- IDs of the subcategories (lists) the subscriber belongs to. Get them from Get Subcategories. Example: [1, 2].
enginemailer_subscriber_unsubscribeUnsubscribe a subscriber from the subscriber list.WriteUnsubscribe Subscriber
Unsubscribe a subscriber from the subscriber list. Returns a status result. Use Activate Subscriber to reactivate a deactivated subscriber.
- Idempotent
Inputs
emailstringrequired- The subscriber's email address. Example: jane@example.com.
enginemailer_subscriber_updateUpdate an existing subscriber's subcategories and custom fields.WriteUpdate Subscriber
Update an existing subscriber's subcategories and custom fields. Returns a status result. Use Get Subscriber to read the current values.
- Idempotent
Inputs
emailstringrequired- Email of the existing subscriber. Example: jane@example.com.
customfield_typeinteger- How to apply custom fields: 0 update only the given fields, 1 replace all (default). Example: 0.one of
01 customfieldsarray- Custom field values. Each item has customfield_key (the field's FieldKey from List Custom Fields) and customfield_value, in the field's format: dates as dd MMM yyyy, phones with + and country code, multiple choices joined with |. Example: [{"customfield_key": "first_name", "customfield_value": "Jane"}].
subcategoriesarray- IDs of the subcategories (lists) the subscriber belongs to. Get them from Get Subcategories. Example: [1, 2].
subcategories_typeinteger- How to apply subcategories: 0 do nothing, 1 append (default), 2 remove the given ones, 3 replace all. Example: 1.one of
0123
enginemailer_subscribers_batch_updateAdd or update up to 5000 subscribers in one job; invalid rows are skipped.WriteBatch Update Subscribers
Add or update up to 5000 subscribers in one job; invalid rows are skipped. Returns an import ID for the job. Use Get Batch Update Status to follow it.
Inputs
subscribersarrayrequired- Up to 5000 subscribers, each with email and an optional customfields list (customfield_key and customfield_value). Example: [{"email": "jane@example.com", "customfields": [{"customfield_key": "first_name", "customfield_value": "Jane"}]}].
sourcetypestring- Label for where the subscribers came from. Example: CRM import.
subcategoriesarray- Subcategory IDs to assign to every subscriber in the batch. Example: [1, 2].
enginemailer_transactional_email_sendSend one transactional email, with your own content or an Enginemailer template and substitution tags.WriteSend Transactional Email
Send one transactional email, with your own content or an Enginemailer template and substitution tags. Returns the submission result. Sends an email to the recipient. Use Create Campaign for bulk marketing campaigns.
Inputs
sender_emailstringrequired- Sender email. Its domain must be a verified sending domain; with a template it must match the template's sender. Example: noreply@acme.com.
to_emailstringrequired- Recipient email address. Example: jane@example.com.
attachmentsarray- Files to attach, total 5 MB at most. Each has Filename (with extension) and Content (base64). Example: [{"Filename": "invoice.txt", "Content": "SGVsbG8="}].
bcc_emailsarray- BCC addresses, up to 3. Example: ["archive@acme.com"].
campaign_namestring- Label to group sends in reports. Example: Order shipped.
cc_emailsarray- CC addresses, up to 10. Example: ["ops@acme.com"].
reply_tostring- Reply-to email address. Example: support@acme.com.
sender_namestring- Sender name. Not needed with template_id. Example: Acme Store.
subjectstring- Email subject. Not needed with template_id. Example: Your order has shipped.
submitted_contentstring- Email body (HTML or text). Not needed with template_id. Example: <p>Your order #1234 is on its way.</p>.
substitution_tagsarray- Template variables to fill, each with Key and Value. Values cannot contain { } [ ]. Example: [{"Key": "order_id", "Value": "1234"}].
template_idinteger- ID of an Enginemailer template to send. Subject and sender name then come from the template. Example: 1023.
enginemailer_transactional_report_exportStart a CSV export of transactional email activity for a date range.WriteExport Transactional Report
Start a CSV export of transactional email activity for a date range. Returns an ExportID and status Processing. Use Get Transactional Export Status to get the download URL when it completes.
Inputs
periodstringrequired- Date range of the report, as "d MMM yyyy - d MMM yyyy". The start can be at most 60 days ago. Example: 1 Nov 2026 - 15 Nov 2026.
domain_filterstring- Only include sends from this sender domain. Example: acme.com.
email_to_filterstring- Only include sends to this email address. Example: jane@example.com.
enginemailer_campaign_deleteDelete an undelivered campaign.DestructiveDelete Campaign
Delete an undelivered campaign. Scheduled, delivering and delivered campaigns cannot be deleted. Returns a status result. Use List Campaigns to find the ID.
- Idempotent
Inputs
campaign_idintegerrequired- Enginemailer campaign ID, from List Campaigns or Create Campaign. Example: 1234.
enginemailer_campaign_recipient_list_deleteRemove the recipient list from an undelivered campaign.DestructiveDelete Recipient List
Remove the recipient list from an undelivered campaign. Returns a status result. Use Assign Recipient List to set a new one.
- Idempotent
Inputs
campaign_idintegerrequired- Enginemailer campaign ID, from List Campaigns or Create Campaign. Example: 1234.
enginemailer_subscriber_deleteDelete a subscriber.DestructiveDelete Subscriber
Delete a subscriber. Returns a status result. Use Unsubscribe Subscriber to keep the record but stop sending.
- Idempotent
Inputs
emailstringrequired- Email of the subscriber to delete. Example: jane@example.com.
No tools match.