The Emelia connector lets your AI agent act in each user's Emelia account. Each user connects their own Emelia API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.
- Tools
- 59
- What they doRead · write · destructive
- 23 · 30 · 623 read30 write6 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 Emelia connection
In AgentKit > Connections, create an Emelia 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 = 'emelia'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Emelia:', 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: 'emelia_blacklists_get',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 = "emelia"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Emelia:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="emelia_blacklists_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Emelia credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolemelia_blacklists_getGet the account-wide blacklists.Read-onlyGet Blacklists
Get the account-wide blacklists. Returns an array of documents with blacklistContent (emails and domains) and linkedinBlacklistContent (LinkedIn handles), newline-separated. Use this to check whether someone is excluded from all campaigns.
Inputs
This tool takes no inputs.
emelia_campaign_activities_listList a campaign's activity events (sends, opens, clicks, replies, LinkedIn actions), newest first, 30 per page.Read-onlyList Campaign Activities
List a campaign's activity events (sends, opens, clicks, replies, LinkedIn actions), newest first, 30 per page. Returns events with type, contact and date; an empty array means no more pages. Use this to see replies or bounces. Pages start at 0 and results may be up to 10 minutes old.
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
contact_idstring- Only this contact's events. Example: 65f1a2b3c4d5e6f74db757ce.
pagestring- Page index, starting at 0. Example: 0.
searchstring- Search contacts by name, email or LinkedIn URL. Example: jane.
typestring- Only this event type. Example: MAIL_REPLIED.one of
VISITEDINVITEDACCEPTEDMESSAGE_SENTINMAIL_SENTLINKEDIN_REPLIEDMAIL_REPLIEDRE_REPLY_EMAILRE_REPLY_LINKEDINFOLLOWEDLIKEDSENTBOUNCEDRE_REPLYOPENEDUNSUBSCRIBEDCLICKEDWEBSITE_VISITEDWHATSAPP_MESSAGE_SENTWHATSAPP_REPLIEDTASK_COMPLETEDTASK_FAILEDFAILED_ACTIONEXCLUDEDMANUAL_EMAIL_SENTMANUAL_LINKEDIN_SENT typesstring- Comma-separated event types; overrides type. Example: MAIL_REPLIED,LINKEDIN_REPLIED.
emelia_campaign_contacts_listList a campaign's contacts with their status in the campaign, page by page.Read-onlyList Campaign Contacts
List a campaign's contacts with their status in the campaign, page by page. Returns contacts with _id, email, names and last event. Use this to find a contact ID or check who replied. Pages start at 0.
Inputs
campaign_idstringrequired- Campaign ID, from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
pageintegerrequired- Page index, starting at 0. Example: 0.
per_pageinteger- Contacts per page, 10 to 10,000. Defaults to 20. Example: 50.
querystring- Exact email, or words matched against email, names, phone and LinkedIn URL. Example: jane@acme.example.
emelia_campaign_getGet a multichannel campaign in full.Read-onlyGet Campaign
Get a multichannel campaign in full. Returns its settings (schedule), sequence steps, sender identities, attached lists with contact counts, status and dates. Read this before any change to settings, steps or identities. Get the ID from emelia_campaigns_list.
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
emelia_campaign_manual_tasks_listList the pending manual TASK steps of a campaign: contacts waiting for someone to do a task.Read-onlyList Campaign Manual Tasks
List the pending manual TASK steps of a campaign: contacts waiting for someone to do a task. Returns tasks with contact and step details. Use this to work through manual follow-ups.
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
emelia_campaign_progress_getGet, for each step of a campaign, how many contacts have passed it and how many are waiting at it.Read-onlyGet Campaign Step Progress
Get, for each step of a campaign, how many contacts have passed it and how many are waiting at it. Returns an object keyed by step ID with completed and waiting counts. Use this to monitor a running campaign. Returns {} for a draft.
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
emelia_campaigns_listList the multichannel campaigns in the Emelia account, newest first, excluding archived ones.Read-onlyList Campaigns
List the multichannel campaigns in the Emelia account, newest first, excluding archived ones. Returns each campaign's _id, name, status and dates. Use this to find a campaign ID. Use emelia_campaign_get for one campaign's sequence and settings.
Inputs
allstring- true to add the synthetic ALL_CAMPAIGNS entry first (used for account-wide webhooks). Example: false.one of
truefalse
emelia_credits_usage_listList the credits consumed by the account (finds and verifications), newest first.Read-onlyList Credit Usage
List the credits consumed by the account (finds and verifications), newest first. Refunded debits are not listed. Returns debits with amount, tool and date. Use this to track spending.
Inputs
limitinteger- Items per page. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
emelia_email_find_result_getGet the result of an email search.Read-onlyGet Email Find Result
Get the result of an email search. Returns the job status (running, done or error) and, when done, the email found. Poll every few seconds after emelia_email_find.
Inputs
job_idstringrequired- jobId returned by emelia_email_find. Example: 6650f1a2b839d80011c5f001.
emelia_email_providers_listList the account's sending mailboxes and the campaigns using them.Read-onlyList Sending Mailboxes
List the account's sending mailboxes and the campaigns using them. Passwords are masked. Returns each mailbox's _id, email, type, sender name and status. Use the _id as a sender identity in emelia_campaign_identities_set.
Inputs
filterstring- disconnected to list only disconnected mailboxes. Example: disconnected.one of
disconnected
emelia_email_verify_result_getGet the result of an email verification.Read-onlyGet Email Verification Result
Get the result of an email verification. Returns the job status and, when done, the qualification (for example deliverable, undeliverable or risky). Poll after emelia_email_verify.
Inputs
job_idstringrequired- jobId returned by emelia_email_verify. Example: 6650f1a2b839d80011c5f003.
emelia_inbox_email_getGet one email's metadata, without the body.Read-onlyGet Inbox Email
Get one email's metadata, without the body. Returns mailboxId, messageId, references, from, to, subject and labels: everything needed to reply in the thread. Use emelia_inbox_email_thread_get for the body.
Inputs
email_idstringrequired- Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.
emelia_inbox_email_thread_getGet an email's HTML and text body plus every message of its conversation, oldest first.Read-onlyGet Inbox Email Body and Thread
Get an email's HTML and text body plus every message of its conversation, oldest first. Returns the body and the thread messages, including ones you sent and drafts. Use this to read a conversation before replying.
Inputs
email_idstringrequired- Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.
emelia_inbox_emails_listList emails in the unified inbox, most recent first, optionally by mailbox or folder.Read-onlyList Inbox Emails
List emails in the unified inbox, most recent first, optionally by mailbox or folder. Returns emails (id, subject, from, snippet, date, read state) and nextCursor. Use this to browse. Use emelia_inbox_emails_search for a keyword and emelia_inbox_email_thread_get for the body.
Inputs
cursorstring- nextCursor from the previous page. Example: eyJpZCI6ImNtZW0ifQ.
folder_typestring- Only this folder. Example: INBOX.one of
INBOXSENTDRAFTSSPAMTRASH limitinteger- Page size, up to 200. Defaults to 50. Example: 50.
mailbox_idstring- Only this mailbox, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.
view_idstring- Apply a saved view. Example: cmvwacme0000000000000001.
emelia_inbox_emails_searchSearch the unified inbox by keyword in subject, sender, snippet and recipients (not the full body).Read-onlySearch Inbox Emails
Search the unified inbox by keyword in subject, sender, snippet and recipients (not the full body). Returns matching emails ranked by relevance and nextCursor. Use emelia_inbox_emails_list to browse without a keyword.
Inputs
qstringrequired- Search term, 2 to 200 characters. Example: partnership.
cursorstring- nextCursor from the previous page. Example: eyJpZCI6ImNtZW0ifQ.
folder_typestring- Only this folder. Example: INBOX.one of
INBOXSENTDRAFTSSPAMTRASH limitinteger- Page size, up to 200. Defaults to 50. Example: 50.
mailbox_idstring- Only this mailbox, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.
emelia_inbox_labels_listList every inbox label, including AI labels and the labels created for each campaign.Read-onlyList Inbox Labels
List every inbox label, including AI labels and the labels created for each campaign. Returns each label's id, name, color and isAiLabel. Use the id with emelia_inbox_email_label_apply.
Inputs
This tool takes no inputs.
emelia_inbox_mailboxes_listList the mailboxes connected to the Emelia unified inbox.Read-onlyList Inbox Mailboxes
List the mailboxes connected to the Emelia unified inbox. Returns each mailbox's id, address and provider. Call this first: mailbox_id is needed to send and to filter emails.
Inputs
This tool takes no inputs.
emelia_linkedin_accounts_listList the LinkedIn accounts connected to the workspace and their state.Read-onlyList LinkedIn Accounts
List the LinkedIn accounts connected to the workspace and their state. Returns each account's id, name and status (active, connecting or disconnected). Use the id as a sender identity in campaigns.
Inputs
This tool takes no inputs.
emelia_list_contacts_listList or look up the contacts in a contact list.Read-onlyList Contacts in List
List or look up the contacts in a contact list. Pass email or linkedin_url for an exact lookup, or page through with search, statuses and sorting. Returns contacts with their id (leadId) and fields. Use an exact lookup before updating or deleting a contact.
Inputs
list_idstringrequired- Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
emailstring- Exact lookup by email (case-insensitive). Not with linkedin_url. Example: jane@acme.example.
linkedin_urlstring- Exact lookup by LinkedIn profile URL, as stored. Not with email. Example: https://www.linkedin.com/in/janedoe.
pageinteger- Page number, starting at 1. Example: 1.
page_sizeinteger- Page size, 1 to 100. Example: 50.
searchstring- Free-text search in names, email and LinkedIn URL. Example: jane.
sort_bystring- Sort field. Example: createdAt.one of
firstNamelastNamefullNamejobTitleemailphonelinkedinUrlProfilecountrycitycreatedAtupdatedAt sort_dirstring- Sort direction. Example: desc.one of
ascdesc statusesstring- Comma-separated engagement statuses, for example SENT, OPENED, MAIL_REPLIED; NO_ACTIVITY for none. Example: MAIL_REPLIED,LINKEDIN_REPLIED.
emelia_list_getGet one contact list with its counters.Read-onlyGet Contact List
Get one contact list with its counters. Returns the list's name, source, status and number of contacts, emails and phones. Use emelia_list_contacts_list for its contacts.
Inputs
list_idstringrequired- Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
emelia_lists_listList the account's top-level contact lists.Read-onlyList Contact Lists
List the account's top-level contact lists. Send page or limit to get a paginated envelope with totals and to use the search and sort options. Returns lists with _id, name, source, status and contact counters. Use this to find a list ID.
Inputs
lead_searchstring- Full email address or LinkedIn profile URL: only lists containing this contact (paginated mode). Example: jane@acme.example.
limitinteger- Page size, up to 100. Example: 50.
pageinteger- Page number, starting at 1. Example: 1.
searchstring- Part of the list name (paginated mode). Example: founders.
sort_bystring- Sort field (paginated mode). Example: createdAt.one of
nameleadsemailsphonescreatedAt sort_dirstring- Sort direction. Example: desc.one of
ascdesc
emelia_phone_find_result_getGet the result of a phone search.Read-onlyGet Phone Find Result
Get the result of a phone search. Returns the job status and, when found, qualification found with phoneNumber. Poll after emelia_phone_find.
Inputs
job_idstringrequired- jobId returned by emelia_phone_find. Example: 6650f1a2b839d80011c5f002.
emelia_warmups_listList the warmup state of every sending mailbox.Read-onlyList Mailbox Warmups
List the warmup state of every sending mailbox. Returns each warmup's _id, mailbox, enabled state and stats. Use emelia_warmup_enable to start warming a mailbox.
Inputs
This tool takes no inputs.
emelia_blacklist_email_addAdd an email address or a whole domain to the account blacklist, so no campaign ever contacts it.WriteAdd Email to Blacklist
Add an email address or a whole domain to the account blacklist, so no campaign ever contacts it. Returns success. Use emelia_blacklist_email_remove to undo.
- Idempotent
Inputs
emailstringrequired- Email address, or a bare domain such as acme.com. Example: competitor.example.
emelia_blacklist_linkedin_addAdd a LinkedIn profile to the account blacklist, so no campaign contacts it on LinkedIn.WriteAdd LinkedIn Profile to Blacklist
Add a LinkedIn profile to the account blacklist, so no campaign contacts it on LinkedIn. Returns success. The profile is stored as its handle.
- Idempotent
Inputs
valuestringrequired- LinkedIn profile URL or bare handle. Example: https://www.linkedin.com/in/janedoe.
emelia_campaign_archiveArchive a campaign so it no longer appears in emelia_campaigns_list.WriteArchive Campaign
Archive a campaign so it no longer appears in emelia_campaigns_list. Returns the campaign. Use emelia_campaign_delete to remove it permanently.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
emelia_campaign_contact_addAdd one contact to a campaign.WriteAdd Contact to Campaign
Add one contact to a campaign. It is stored in the campaign's API list and scheduled right away if the campaign is running. Returns success. Use emelia_list_contacts_batch_add plus emelia_campaign_lists_set for many contacts. Duplicates (same email or LinkedIn URL) are rejected.
Inputs
campaign_idstringrequired- Campaign ID, from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
contactobjectrequired- Contact as a flat object of field names and scalar values. Needs email or linkedinUrlProfile. Native fields include firstName, lastName, phone, companyName and jobTitle; any other key becomes a custom variable usable as {{key}} in messages. Empty values are ignored. Example: {"email": "jane@acme.example", "firstName": "Jane", "lastName": "Doe", "companyName": "Acme"}
emelia_campaign_createCreate an empty multichannel (email, LinkedIn, WhatsApp) campaign in DRAFT with default settings and only a START step.WriteCreate Campaign
Create an empty multichannel (email, LinkedIn, WhatsApp) campaign in DRAFT with default settings and only a START step. Returns the new campaign with its _id. Next, set lists with emelia_campaign_lists_set, senders with emelia_campaign_identities_set and steps with emelia_campaign_steps_replace, then start it.
Inputs
namestringrequired- Campaign name, unique in the account. Example: Q1 SaaS founders outreach.
time_zonestring- IANA time zone for the sending schedule. Defaults to Europe/Brussels. Example: America/New_York.
emelia_campaign_duplicateCopy a campaign into a new DRAFT, choosing whether to copy settings, steps, contacts and senders.WriteDuplicate Campaign
Copy a campaign into a new DRAFT, choosing whether to copy settings, steps, contacts and senders. Returns the new campaign. Copied lists and contacts are shared, not copied.
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
namestringrequired- Name of the new campaign, unique in the account. Example: Q2 SaaS founders outreach.
copy_contactsboolean- Use the same contacts and lists. Example: false.
copy_identitiesboolean- Use the same senders. Example: true.
copy_settingsboolean- Copy the schedule and settings. Example: true.
copy_stepsboolean- Copy the sequence. Example: true.
emelia_campaign_identities_setReplace the sender identities (mailboxes and LinkedIn accounts) a campaign sends from.WriteSet Campaign Senders
Replace the sender identities (mailboxes and LinkedIn accounts) a campaign sends from. Not allowed while RUNNING. Returns the updated campaign. Get mailbox IDs from emelia_email_providers_list and LinkedIn accounts from emelia_linkedin_accounts_list.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
identitiesarrayrequired- Sender identities. Each item has email (an email provider _id) and/or linkedin (a LinkedIn account id). Example: [{"email": "6650f1a2b839d80011c5a0aa"}]
emelia_campaign_lists_setSet the full selection of contact lists a campaign sends to, optionally with exclusion lists.WriteSet Campaign Contact Lists
Set the full selection of contact lists a campaign sends to, optionally with exclusion lists. Allowed while running. Returns the updated campaign. This replaces the current lists. Build lists with emelia_list_create and emelia_list_contact_add. A campaign can start with at most 30,000 recipients.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
listsarrayrequired- IDs of the lists to send to, from emelia_lists_list. Example: ["65f1a2b3c4d5e6f760f68df4"]
excluded_listsarray- IDs of lists whose contacts are excluded. Omit to keep the current exclusions. Example: ["65f1a2b3c4d5e6f760f68df5"]
emelia_campaign_pausePause a RUNNING campaign: its scheduled actions stop until it is started again.WritePause Campaign
Pause a RUNNING campaign: its scheduled actions stop until it is started again. Returns the campaign. Use emelia_campaign_start to resume.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
emelia_campaign_planned_start_setSchedule a campaign to start automatically at a future time, or cancel a scheduled start.WriteSchedule Campaign Start
Schedule a campaign to start automatically at a future time, or cancel a scheduled start. Returns the campaign. The campaign must pass the start checks now. Leave planned_start empty to cancel.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
planned_startstring- Start time in ISO 8601, in the future. Omit to cancel the planned start. Example: 2026-02-02T08:00:00Z.
emelia_campaign_renameRename a campaign.WriteRename Campaign
Rename a campaign. Not allowed while it is RUNNING. Returns the updated campaign. Get the ID from emelia_campaigns_list.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
namestringrequired- New campaign name, unique in the account. Example: Q1 SaaS founders outreach v2.
emelia_campaign_settings_updateMerge new schedule and sending settings into a campaign.WriteUpdate Campaign Settings
Merge new schedule and sending settings into a campaign. Not allowed while RUNNING. Returns the updated campaign. Read emelia_campaign_get first and send complete settings: trackLinks, trackOpens, blacklistUnsub, start and end are needed.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
settingsobjectrequired- Settings to merge: start and end (HH:mm), days, timeZone, dailyEmailLimit, dailyEmailAdded, dailyLinkedinAdded (max 40 with a CONNECTION step), trackLinks, trackOpens and blacklistUnsub. Example: {"start": "08:00", "end": "17:00", "trackOpens": false, "trackLinks": false, "blacklistUnsub": true, "dailyEmailAdded": 35}
emelia_campaign_startStart or resume a campaign so it begins contacting recipients.WriteStart Campaign
Start or resume a campaign so it begins contacting recipients. Requires an active subscription. Returns the campaign, or the first failing start check with a stable code. Check senders, lists and step content first. Use emelia_campaign_pause to stop it.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
emelia_campaign_steps_replaceReplace the whole sequence tree of a campaign (emails, LinkedIn actions, WhatsApp, tasks, conditions).WriteReplace Campaign Sequence
Replace the whole sequence tree of a campaign (emails, LinkedIn actions, WhatsApp, tasks, conditions). The campaign must not be RUNNING. Returns the updated campaign. Always read the current tree with emelia_campaign_get, edit it and send it back complete. New steps leave out _id.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
stepsobjectrequired- Root node of the sequence: a START step whose next points to the following step. Each node has stepType (EMAIL, CONNECTION, MESSAGE, INMAIL, VISIT, LIKE, WHATSAPP, TASK, CONDITION, END_OF_CAMPAIGN), a delay {amount, unit}, versions with subject and message for content steps, and next, or yes and no for a CONDITION. Example: {"_id": "START", "stepType": "START", "delay": {"amount": 0, "unit": "DAYS"}, "next": {"stepType": "EMAIL", "delay": {"amount": 0, "unit": "DAYS"}, "identiti...
emelia_email_findStart a search for a person's professional email from their name, company and country.WriteFind Email
Start a search for a person's professional email from their name, company and country. Costs 1 credit, refunded if nothing is found. Returns a jobId immediately. Poll emelia_email_find_result_get with the jobId until status is done.
Inputs
company_namestringrequired- Company name. Example: Acme.
countrystringrequired- Person's country, ISO 3166-1 alpha-2 code. Example: US.
fullnamestringrequired- Person's first and last name. Example: Jane Doe.
company_websitestring- Company domain or website. Strongly improves results. Example: acme.example.
emelia_email_provider_sender_name_updateChange the sender name shown on emails from a mailbox.WriteUpdate Mailbox Sender Name
Change the sender name shown on emails from a mailbox. Returns the updated mailbox. Outlook always shows the Microsoft account name.
- Idempotent
Inputs
provider_idstringrequired- Mailbox (email provider) ID, from emelia_email_providers_list. Example: 6650f1a2b839d80011c5a0aa.
sender_namestringrequired- New sender name. Example: Jane from Acme.
emelia_email_verifyStart verifying that an email address can receive mail.WriteVerify Email
Start verifying that an email address can receive mail. Costs 0.25 credit, never refunded. Returns a jobId immediately. Poll emelia_email_verify_result_get every few seconds; the job errors after about 60 seconds without a verdict.
Inputs
emailstringrequired- Email address to verify. Example: jane@acme.example.
emelia_inbox_draft_createCreate a draft in one of the mailboxes, for a person to review and send from the Emelia inbox.WriteCreate Inbox Draft
Create a draft in one of the mailboxes, for a person to review and send from the Emelia inbox. Returns the draft. Use this to prepare a reply while keeping a human in the loop. Use emelia_inbox_email_send to send immediately.
Inputs
bodyobjectrequired- Message body: html, text or both. Example: {"html": "<p>Hi Jane,</p><p>Thanks for your reply.</p>", "text": "Hi Jane, thanks for your reply."}
mailbox_idstringrequired- Mailbox to create the draft in, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.
ccarray- CC recipients. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]
in_reply_tostring- messageId of the email being answered, to join its thread (from emelia_inbox_email_get). Example: <CAF1234@mail.gmail.com>.
referencesarray- References of the answered email followed by its messageId. Example: ["<CAF1234@mail.gmail.com>"]
signaturestring- default (the mailbox's default signature), none, or a signature ID. Example: default.
subjectstring- Subject. Example: Re: Partnership.
toarray- Recipients, each with email and optional name. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]
emelia_inbox_email_label_applyApply a label to an inbox email.WriteApply Label to Email
Apply a label to an inbox email. Applying a label it already has changes nothing. Returns the email's labels. Get label IDs from emelia_inbox_labels_list.
- Idempotent
Inputs
email_idstringrequired- Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.
label_idstringrequired- Label ID, from emelia_inbox_labels_list. Example: cmtgacme0000000000000001.
emelia_inbox_email_sendSend an email immediately from one of the inbox mailboxes, as a new message or a threaded reply.WriteSend Inbox Email
Send an email immediately from one of the inbox mailboxes, as a new message or a threaded reply. Returns the sent message. This reaches the recipient and cannot be undone. To reply in a thread, send from the original's mailbox with in_reply_to and references from emelia_inbox_email_get.
Inputs
bodyobjectrequired- Message body: html, text or both. Example: {"html": "<p>Hi Jane,</p><p>Thanks for your reply.</p>", "text": "Hi Jane, thanks for your reply."}
mailbox_idstringrequired- Sending mailbox, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.
toarrayrequired- Recipients, each with email and optional name. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]
ccarray- CC recipients. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]
in_reply_tostring- messageId of the email being answered. Example: <CAF1234@mail.gmail.com>.
referencesarray- References of the answered email followed by its messageId. Example: ["<CAF1234@mail.gmail.com>"]
signaturestring- default (the mailbox's default signature), none, or a signature ID. Example: default.
subjectstring- Subject, without line breaks. Example: Re: Partnership.
emelia_inbox_email_updateMark an email read or unread, starred or unstarred.WriteMark Inbox Email
Mark an email read or unread, starred or unstarred. Returns the updated email. Send at least one of is_read or is_starred.
- Idempotent
Inputs
email_idstringrequired- Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.
is_readboolean- true marks it read, false unread. Example: true.
is_starredboolean- true stars it, false unstars it. Example: false.
emelia_list_contact_addAdd one contact to a list, or update it when update_if_exists is true.WriteAdd Contact to List
Add one contact to a list, or update it when update_if_exists is true. Running campaigns using the list pick the contact up. Returns the contact's leadId and whether it was added or updated. Use emelia_list_contacts_batch_add for up to 100 contacts at once.
Inputs
contactobjectrequired- Contact as a flat object of field names and scalar values. Needs email or linkedinUrlProfile. Native fields include firstName, lastName, phone, companyName and jobTitle; any other key becomes a custom variable usable as {{key}} in messages. Empty values are ignored. Example: {"email": "jane@acme.example", "firstName": "Jane", "lastName": "Doe", "companyName": "Acme"}
list_idstringrequired- Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
update_if_existsstring- true to update the existing contact when a duplicate (same email or LinkedIn URL) is found, instead of ignoring it. Example: true.one of
truefalse
emelia_list_contact_updateUpdate a contact's fields by its ID.WriteUpdate List Contact
Update a contact's fields by its ID. Unknown keys become custom variables; empty values are ignored. Returns the updated contact. Find the contact ID with emelia_list_contacts_list.
- Idempotent
Inputs
contact_idstringrequired- Contact ID (leadId), from emelia_list_contacts_list. Example: 65f1a2b3c4d5e6f74db757ce.
fieldsobjectrequired- Fields to set, as a flat object of field names and scalar values. Example: {"jobTitle": "CEO", "phone": "+1 555 0100"}
emelia_list_contacts_batch_addAdd 1 to 100 contacts to a list in one call, with the same rules as adding one.WriteAdd Contacts to List (Batch)
Add 1 to 100 contacts to a list in one call, with the same rules as adding one. Returns per-row results. Use emelia_list_contact_add for one contact.
Inputs
contactsarrayrequired- Up to 100 contacts, each a flat object like in emelia_list_contact_add. Example: [{"email": "jane@acme.example", "firstName": "Jane"}, {"email": "john@globex.example", "firstName": "John"}]
list_idstringrequired- Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
update_if_existsstring- true to update the existing contact when a duplicate (same email or LinkedIn URL) is found, instead of ignoring it. Example: true.one of
truefalse
emelia_list_createCreate an empty contact list, ready for contacts.WriteCreate Contact List
Create an empty contact list, ready for contacts. Returns the new listId. Names need not be unique, so store the returned ID. Add contacts with emelia_list_contact_add.
Inputs
namestringrequired- List name. Example: SaaS founders - US.
emelia_list_renameRename a contact list.WriteRename Contact List
Rename a contact list. Returns the updated list. Get the ID from emelia_lists_list.
- Idempotent
Inputs
list_idstringrequired- Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
namestringrequired- New list name. Example: SaaS founders - US (Q1)
emelia_phone_findStart a search for a person's mobile number from their LinkedIn profile URL.WriteFind Phone Number
Start a search for a person's mobile number from their LinkedIn profile URL. Costs 50 credits, refunded if no number is found. Returns a jobId immediately. Poll emelia_phone_find_result_get until status is done.
Inputs
linkedin_urlstringrequired- LinkedIn profile URL; must contain linkedin.com/in/. Example: https://www.linkedin.com/in/janedoe.
emelia_reply_sendSend an email from one of your connected sending mailboxes, threaded as a reply when message_id is given.WriteSend Reply from Mailbox
Send an email from one of your connected sending mailboxes, threaded as a reply when message_id is given. Returns success. Use this to answer a prospect's reply. Pick the mailbox with provider_id or sender_email. This sends immediately.
Inputs
contentstringrequired- HTML body. Use <br> for line breaks. Example: Hi Jane,<br>Thanks for getting back to me.
ccarray- CC email addresses. Example: ["boss@acme.example"]
message_idstring- Message-ID of the email being answered, to thread the reply. Example: <CAF1234@mail.gmail.com>.
provider_idstring- Sending mailbox ID, from emelia_email_providers_list (or give sender_email). Example: 6650f1a2b839d80011c5a0aa.
scheduled_atstring- Send later at this ISO 8601 time. Example: 2026-02-02T09:00:00Z.
sender_emailstring- Sending mailbox address (or give provider_id). Example: jane@mycompany.example.
subjectstring- Subject. Needed when message_id is not given. Example: Re: Quick question.
toarray- Recipient email addresses. Needed when message_id is not given. Example: ["jane@acme.example"]
emelia_warmup_enableStart warming up a sending mailbox.WriteEnable Mailbox Warmup
Start warming up a sending mailbox. Requires an active subscription; the mailbox connection is tested first. Returns the warmup. Get the mailbox ID from emelia_email_providers_list.
- Idempotent
Inputs
provider_idstringrequired- Mailbox (email provider) ID or warmup ID. Example: 6650f1a2b839d80011c5a0aa.
emelia_webhook_createRegister a URL that receives a JSON POST when chosen events happen on a multichannel campaign, or on all of them.WriteCreate Campaign Webhook
Register a URL that receives a JSON POST when chosen events happen on a multichannel campaign, or on all of them. Returns the registration. Use ALL_CAMPAIGNS as campaign_id for every campaign. Deliveries are not signed, so use a hard-to-guess HTTPS URL.
Inputs
campaign_idstringrequired- Campaign ID, or ALL_CAMPAIGNS. Example: 6650f1a2b839d80011c5a0f1.
eventsarrayrequired- Events to receive, for example MAIL_REPLIED, LINKEDIN_REPLIED, SENT, OPENED, CLICKED, BOUNCED, UNSUBSCRIBED. Example: ["MAIL_REPLIED", "LINKEDIN_REPLIED"]
hook_urlstringrequired- Public HTTPS URL that receives the events. Example: https://hooks.example.com/emelia/9f2c4e1a7b.
emelia_blacklist_email_removeRemove an email address or domain from the account blacklist.DestructiveRemove Email from Blacklist
Remove an email address or domain from the account blacklist. Returns success. Use emelia_blacklists_get to see current entries.
- Idempotent
Inputs
emailstringrequired- Email address or bare domain to remove. Example: competitor.example.
emelia_campaign_contact_removeRemove one contact from a campaign and delete its activity there.DestructiveRemove Contact from Campaign
Remove one contact from a campaign and delete its activity there. The contact and its lists are kept. Returns success. Get the contact ID from emelia_campaign_contacts_list.
- Idempotent
Inputs
campaign_idstringrequired- Campaign ID. Example: 6650f1a2b839d80011c5a0f1.
contact_idstringrequired- Contact ID (24 hex characters), from emelia_campaign_contacts_list. Example: 65f1a2b3c4d5e6f74db757ce.
emelia_campaign_deleteDelete a campaign permanently.DestructiveDelete Campaign
Delete a campaign permanently. A running campaign must be paused first. Returns success. This cannot be undone; use emelia_campaign_archive to hide it instead.
- Idempotent
Inputs
campaign_idstringrequired- Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
emelia_list_contact_deleteDelete a contact permanently from a list and from the campaigns using it.DestructiveDelete List Contact
Delete a contact permanently from a list and from the campaigns using it. Returns success. This cannot be undone. Find the contact ID with emelia_list_contacts_list.
- Idempotent
Inputs
contact_idstringrequired- Contact ID (leadId), from emelia_list_contacts_list. Example: 65f1a2b3c4d5e6f7af1c3d42.
list_idstringrequired- Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
emelia_list_deleteDelete a contact list permanently, with every contact in it and its linked lists.DestructiveDelete Contact List
Delete a contact list permanently, with every contact in it and its linked lists. Returns success. This cannot be undone and removes the contacts from campaigns using the list.
- Idempotent
Inputs
list_idstringrequired- Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
emelia_webhook_deleteRemove a webhook URL from a multichannel campaign, or from all of them with ALL_CAMPAIGNS.DestructiveDelete Campaign Webhook
Remove a webhook URL from a multichannel campaign, or from all of them with ALL_CAMPAIGNS. Returns success, also when the URL was not registered. The URL must match exactly.
- Idempotent
Inputs
campaign_idstringrequired- Campaign ID, or ALL_CAMPAIGNS. Example: 6650f1a2b839d80011c5a0f1.
hook_urlstringrequired- The URL exactly as registered. Example: https://hooks.example.com/emelia/9f2c4e1a7b.
No tools match.