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

---

# Connect AI agents to Emelia

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.

**Authentication:** API Key
**Categories:** CRM & Sales, Marketing
**Tools:** 59: 23 read, 30 write, 6 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=EMELIA)

## Setup

1. ### Install the SDK

   **Node.js**

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

   **Python**

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

2. ### Set your credentials

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

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

3. ### Create the Emelia connection

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

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

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

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

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

   const connector = 'emelia'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { 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 call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'emelia_blacklists_get',
     toolInput: {},
   })
   console.log(result)
   ```

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

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

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

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

   connection_name = "emelia"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_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 call
   result = actions.execute_tool(
       tool_input={},
       tool_name="emelia_blacklists_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

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

## Tools

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

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'emelia_blacklists_get',
  toolInput: {},
  connector: 'emelia',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="emelia_blacklists_get",
    tool_input={},
    connection_name="emelia",
    identifier="user_123",
)
```

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

### `emelia_blacklists_get`

Get Blacklists · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `emelia_campaign_activities_list`

List Campaign Activities · Read-only

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `contact_id` (`string`, optional): Only this contact's events. Example: 65f1a2b3c4d5e6f74db757ce.
- `page` (`string`, optional): Page index, starting at 0. Example: 0.
- `search` (`string`, optional): Search contacts by name, email or LinkedIn URL. Example: jane.
- `type` (`string`, optional): Only this event type. Example: MAIL_REPLIED. One of: `VISITED`, `INVITED`, `ACCEPTED`, `MESSAGE_SENT`, `INMAIL_SENT`, `LINKEDIN_REPLIED`, `MAIL_REPLIED`, `RE_REPLY_EMAIL`, `RE_REPLY_LINKEDIN`, `FOLLOWED`, `LIKED`, `SENT`, `BOUNCED`, `RE_REPLY`, `OPENED`, `UNSUBSCRIBED`, `CLICKED`, `WEBSITE_VISITED`, `WHATSAPP_MESSAGE_SENT`, `WHATSAPP_REPLIED`, `TASK_COMPLETED`, `TASK_FAILED`, `FAILED_ACTION`, `EXCLUDED`, `MANUAL_EMAIL_SENT`, `MANUAL_LINKEDIN_SENT`.
- `types` (`string`, optional): Comma-separated event types; overrides type. Example: MAIL_REPLIED,LINKEDIN_REPLIED.

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

### `emelia_campaign_contacts_list`

List Campaign Contacts · Read-only

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.

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

Inputs:

- `campaign_id` (`string`, required): Campaign ID, from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `page` (`integer`, required): Page index, starting at 0. Example: 0.
- `per_page` (`integer`, optional): Contacts per page, 10 to 10,000. Defaults to 20. Example: 50.
- `query` (`string`, optional): Exact email, or words matched against email, names, phone and LinkedIn URL. Example: jane@acme.example.

Example input: `{"campaign_id":"<campaign_id>","page":0}`

### `emelia_campaign_get`

Get Campaign · Read-only

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.

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

### `emelia_campaign_manual_tasks_list`

List Campaign Manual Tasks · Read-only

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.

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

### `emelia_campaign_progress_get`

Get Campaign Step Progress · Read-only

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.

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

### `emelia_campaigns_list`

List Campaigns · Read-only

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.

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

Inputs:

- `all` (`string`, optional): true to add the synthetic ALL_CAMPAIGNS entry first (used for account-wide webhooks). Example: false. One of: `true`, `false`.

Example input: `{}`

### `emelia_credits_usage_list`

List Credit Usage · Read-only

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.

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

Inputs:

- `limit` (`integer`, optional): Items per page. Example: 50.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.

Example input: `{}`

### `emelia_email_find_result_get`

Get Email Find Result · Read-only

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.

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

Inputs:

- `job_id` (`string`, required): jobId returned by emelia_email_find. Example: 6650f1a2b839d80011c5f001.

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

### `emelia_email_providers_list`

List Sending Mailboxes · Read-only

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.

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

Inputs:

- `filter` (`string`, optional): disconnected to list only disconnected mailboxes. Example: disconnected. One of: `disconnected`.

Example input: `{}`

### `emelia_email_verify_result_get`

Get Email Verification Result · Read-only

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.

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

Inputs:

- `job_id` (`string`, required): jobId returned by emelia_email_verify. Example: 6650f1a2b839d80011c5f003.

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

### `emelia_inbox_email_get`

Get Inbox Email · Read-only

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.

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

Inputs:

- `email_id` (`string`, required): Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.

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

### `emelia_inbox_email_thread_get`

Get Inbox Email Body and Thread · Read-only

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.

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

Inputs:

- `email_id` (`string`, required): Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.

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

### `emelia_inbox_emails_list`

List Inbox Emails · Read-only

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.

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

Inputs:

- `cursor` (`string`, optional): nextCursor from the previous page. Example: eyJpZCI6ImNtZW0ifQ.
- `folder_type` (`string`, optional): Only this folder. Example: INBOX. One of: `INBOX`, `SENT`, `DRAFTS`, `SPAM`, `TRASH`.
- `limit` (`integer`, optional): Page size, up to 200. Defaults to 50. Example: 50.
- `mailbox_id` (`string`, optional): Only this mailbox, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.
- `view_id` (`string`, optional): Apply a saved view. Example: cmvwacme0000000000000001.

Example input: `{}`

### `emelia_inbox_emails_search`

Search Inbox Emails · Read-only

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.

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

Inputs:

- `q` (`string`, required): Search term, 2 to 200 characters. Example: partnership.
- `cursor` (`string`, optional): nextCursor from the previous page. Example: eyJpZCI6ImNtZW0ifQ.
- `folder_type` (`string`, optional): Only this folder. Example: INBOX. One of: `INBOX`, `SENT`, `DRAFTS`, `SPAM`, `TRASH`.
- `limit` (`integer`, optional): Page size, up to 200. Defaults to 50. Example: 50.
- `mailbox_id` (`string`, optional): Only this mailbox, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.

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

### `emelia_inbox_labels_list`

List Inbox Labels · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `emelia_inbox_mailboxes_list`

List Inbox Mailboxes · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `emelia_linkedin_accounts_list`

List LinkedIn Accounts · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `emelia_list_contacts_list`

List Contacts in List · Read-only

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.

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

Inputs:

- `list_id` (`string`, required): Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
- `email` (`string`, optional): Exact lookup by email (case-insensitive). Not with linkedin_url. Example: jane@acme.example.
- `linkedin_url` (`string`, optional): Exact lookup by LinkedIn profile URL, as stored. Not with email. Example: https://www.linkedin.com/in/janedoe.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `page_size` (`integer`, optional): Page size, 1 to 100. Example: 50.
- `search` (`string`, optional): Free-text search in names, email and LinkedIn URL. Example: jane.
- `sort_by` (`string`, optional): Sort field. Example: createdAt. One of: `firstName`, `lastName`, `fullName`, `jobTitle`, `email`, `phone`, `linkedinUrlProfile`, `country`, `city`, `createdAt`, `updatedAt`.
- `sort_dir` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.
- `statuses` (`string`, optional): Comma-separated engagement statuses, for example SENT, OPENED, MAIL_REPLIED; NO_ACTIVITY for none. Example: MAIL_REPLIED,LINKEDIN_REPLIED.

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

### `emelia_list_get`

Get Contact List · Read-only

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.

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

Inputs:

- `list_id` (`string`, required): Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.

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

### `emelia_lists_list`

List Contact Lists · Read-only

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.

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

Inputs:

- `lead_search` (`string`, optional): Full email address or LinkedIn profile URL: only lists containing this contact (paginated mode). Example: jane@acme.example.
- `limit` (`integer`, optional): Page size, up to 100. Example: 50.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `search` (`string`, optional): Part of the list name (paginated mode). Example: founders.
- `sort_by` (`string`, optional): Sort field (paginated mode). Example: createdAt. One of: `name`, `leads`, `emails`, `phones`, `createdAt`.
- `sort_dir` (`string`, optional): Sort direction. Example: desc. One of: `asc`, `desc`.

Example input: `{}`

### `emelia_phone_find_result_get`

Get Phone Find Result · Read-only

Get the result of a phone search.
Returns the job status and, when found, qualification found with phoneNumber.
Poll after emelia_phone_find.

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

Inputs:

- `job_id` (`string`, required): jobId returned by emelia_phone_find. Example: 6650f1a2b839d80011c5f002.

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

### `emelia_warmups_list`

List Mailbox Warmups · Read-only

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.

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

Inputs: none.

Example input: `{}`

### `emelia_blacklist_email_add`

Add Email to Blacklist · Write

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.

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

Inputs:

- `email` (`string`, required): Email address, or a bare domain such as acme.com. Example: competitor.example.

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

### `emelia_blacklist_linkedin_add`

Add LinkedIn Profile to Blacklist · Write

Add a LinkedIn profile to the account blacklist, so no campaign contacts it on LinkedIn.
Returns success.
The profile is stored as its handle.

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

Inputs:

- `value` (`string`, required): LinkedIn profile URL or bare handle. Example: https://www.linkedin.com/in/janedoe.

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

### `emelia_campaign_archive`

Archive Campaign · Write

Archive a campaign so it no longer appears in emelia_campaigns_list.
Returns the campaign.
Use emelia_campaign_delete to remove it permanently.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.

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

### `emelia_campaign_contact_add`

Add Contact to Campaign · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Campaign ID, from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `contact` (`object`, required): 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"}

Example input: `{"campaign_id":"<campaign_id>","contact":{"email":"jane@acme.example","firstName":"Jane","lastName":"Doe","companyName":"Acme"}}`

### `emelia_campaign_create`

Create Campaign · Write

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.

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

Inputs:

- `name` (`string`, required): Campaign name, unique in the account. Example: Q1 SaaS founders outreach.
- `time_zone` (`string`, optional): IANA time zone for the sending schedule. Defaults to Europe/Brussels. Example: America/New_York.

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

### `emelia_campaign_duplicate`

Duplicate Campaign · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `name` (`string`, required): Name of the new campaign, unique in the account. Example: Q2 SaaS founders outreach.
- `copy_contacts` (`boolean`, optional): Use the same contacts and lists. Example: false.
- `copy_identities` (`boolean`, optional): Use the same senders. Example: true.
- `copy_settings` (`boolean`, optional): Copy the schedule and settings. Example: true.
- `copy_steps` (`boolean`, optional): Copy the sequence. Example: true.

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

### `emelia_campaign_identities_set`

Set Campaign Senders · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `identities` (`array`, required): Sender identities. Each item has email (an email provider _id) and/or linkedin (a LinkedIn account id). Example: [{"email": "6650f1a2b839d80011c5a0aa"}]

Example input: `{"campaign_id":"<campaign_id>","identities":[{"email":"6650f1a2b839d80011c5a0aa"}]}`

### `emelia_campaign_lists_set`

Set Campaign Contact Lists · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `lists` (`array`, required): IDs of the lists to send to, from emelia_lists_list. Example: ["65f1a2b3c4d5e6f760f68df4"]
- `excluded_lists` (`array`, optional): IDs of lists whose contacts are excluded. Omit to keep the current exclusions. Example: ["65f1a2b3c4d5e6f760f68df5"]

Example input: `{"campaign_id":"<campaign_id>","lists":["65f1a2b3c4d5e6f760f68df4"]}`

### `emelia_campaign_pause`

Pause Campaign · Write

Pause a RUNNING campaign: its scheduled actions stop until it is started again.
Returns the campaign.
Use emelia_campaign_start to resume.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.

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

### `emelia_campaign_planned_start_set`

Schedule Campaign Start · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `planned_start` (`string`, optional): Start time in ISO 8601, in the future. Omit to cancel the planned start. Example: 2026-02-02T08:00:00Z.

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

### `emelia_campaign_rename`

Rename Campaign · Write

Rename a campaign. Not allowed while it is RUNNING.
Returns the updated campaign.
Get the ID from emelia_campaigns_list.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `name` (`string`, required): New campaign name, unique in the account. Example: Q1 SaaS founders outreach v2.

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

### `emelia_campaign_settings_update`

Update Campaign Settings · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `settings` (`object`, required): 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}

Example input: `{"campaign_id":"<campaign_id>","settings":{"start":"08:00","end":"17:00","trackOpens":false,"trackLinks":false,"blacklistUnsub":true,"dailyEmailAdded":35}}`

### `emelia_campaign_start`

Start Campaign · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.

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

### `emelia_campaign_steps_replace`

Replace Campaign Sequence · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.
- `steps` (`object`, required): 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...

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

### `emelia_email_find`

Find Email · Write

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.

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

Inputs:

- `company_name` (`string`, required): Company name. Example: Acme.
- `country` (`string`, required): Person's country, ISO 3166-1 alpha-2 code. Example: US.
- `fullname` (`string`, required): Person's first and last name. Example: Jane Doe.
- `company_website` (`string`, optional): Company domain or website. Strongly improves results. Example: acme.example.

Example input: `{"company_name":"<company_name>","country":"<country>","fullname":"<fullname>"}`

### `emelia_email_provider_sender_name_update`

Update Mailbox Sender Name · Write

Change the sender name shown on emails from a mailbox.
Returns the updated mailbox.
Outlook always shows the Microsoft account name.

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

Inputs:

- `provider_id` (`string`, required): Mailbox (email provider) ID, from emelia_email_providers_list. Example: 6650f1a2b839d80011c5a0aa.
- `sender_name` (`string`, required): New sender name. Example: Jane from Acme.

Example input: `{"provider_id":"<provider_id>","sender_name":"<sender_name>"}`

### `emelia_email_verify`

Verify Email · Write

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.

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

Inputs:

- `email` (`string`, required): Email address to verify. Example: jane@acme.example.

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

### `emelia_inbox_draft_create`

Create Inbox Draft · Write

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.

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

Inputs:

- `body` (`object`, required): Message body: html, text or both. Example: {"html": "Hi Jane,
Thanks for your reply.
", "text": "Hi Jane, thanks for your reply."}
- `mailbox_id` (`string`, required): Mailbox to create the draft in, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.
- `cc` (`array`, optional): CC recipients. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]
- `in_reply_to` (`string`, optional): messageId of the email being answered, to join its thread (from emelia_inbox_email_get). Example: <CAF1234@mail.gmail.com>.
- `references` (`array`, optional): References of the answered email followed by its messageId. Example: ["<CAF1234@mail.gmail.com>"]
- `signature` (`string`, optional): default (the mailbox's default signature), none, or a signature ID. Example: default.
- `subject` (`string`, optional): Subject. Example: Re: Partnership.
- `to` (`array`, optional): Recipients, each with email and optional name. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]

Example input: `{"body":{"html":"<p>Hi Jane,</p><p>Thanks for your reply.</p>","text":"Hi Jane, thanks for your reply."},"mailbox_id":"<mailbox_id>"}`

### `emelia_inbox_email_label_apply`

Apply Label to Email · Write

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.

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

Inputs:

- `email_id` (`string`, required): Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.
- `label_id` (`string`, required): Label ID, from emelia_inbox_labels_list. Example: cmtgacme0000000000000001.

Example input: `{"email_id":"<email_id>","label_id":"<label_id>"}`

### `emelia_inbox_email_send`

Send Inbox Email · Write

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.

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

Inputs:

- `body` (`object`, required): Message body: html, text or both. Example: {"html": "Hi Jane,
Thanks for your reply.
", "text": "Hi Jane, thanks for your reply."}
- `mailbox_id` (`string`, required): Sending mailbox, from emelia_inbox_mailboxes_list. Example: cmbxacme0000000000000001.
- `to` (`array`, required): Recipients, each with email and optional name. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]
- `cc` (`array`, optional): CC recipients. Example: [{"email": "jane@acme.example", "name": "Jane Doe"}]
- `in_reply_to` (`string`, optional): messageId of the email being answered. Example: <CAF1234@mail.gmail.com>.
- `references` (`array`, optional): References of the answered email followed by its messageId. Example: ["<CAF1234@mail.gmail.com>"]
- `signature` (`string`, optional): default (the mailbox's default signature), none, or a signature ID. Example: default.
- `subject` (`string`, optional): Subject, without line breaks. Example: Re: Partnership.

Example input: `{"body":{"html":"<p>Hi Jane,</p><p>Thanks for your reply.</p>","text":"Hi Jane, thanks for your reply."},"mailbox_id":"<mailbox_id>","to":[{"email":"jane@acme.example","name":"Jane Doe"}]}`

### `emelia_inbox_email_update`

Mark Inbox Email · Write

Mark an email read or unread, starred or unstarred.
Returns the updated email.
Send at least one of is_read or is_starred.

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

Inputs:

- `email_id` (`string`, required): Inbox email ID, from emelia_inbox_emails_list or emelia_inbox_emails_search. Example: cmemacme0000000000000001.
- `is_read` (`boolean`, optional): true marks it read, false unread. Example: true.
- `is_starred` (`boolean`, optional): true stars it, false unstars it. Example: false.

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

### `emelia_list_contact_add`

Add Contact to List · Write

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.

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

Inputs:

- `contact` (`object`, required): 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_id` (`string`, required): Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
- `update_if_exists` (`string`, optional): true to update the existing contact when a duplicate (same email or LinkedIn URL) is found, instead of ignoring it. Example: true. One of: `true`, `false`.

Example input: `{"contact":{"email":"jane@acme.example","firstName":"Jane","lastName":"Doe","companyName":"Acme"},"list_id":"<list_id>"}`

### `emelia_list_contact_update`

Update List Contact · Write

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.

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

Inputs:

- `contact_id` (`string`, required): Contact ID (leadId), from emelia_list_contacts_list. Example: 65f1a2b3c4d5e6f74db757ce.
- `fields` (`object`, required): Fields to set, as a flat object of field names and scalar values. Example: {"jobTitle": "CEO", "phone": "+1 555 0100"}

Example input: `{"contact_id":"<contact_id>","fields":{"jobTitle":"CEO","phone":"+1 555 0100"}}`

### `emelia_list_contacts_batch_add`

Add Contacts to List (Batch) · Write

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.

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

Inputs:

- `contacts` (`array`, required): 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_id` (`string`, required): Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
- `update_if_exists` (`string`, optional): true to update the existing contact when a duplicate (same email or LinkedIn URL) is found, instead of ignoring it. Example: true. One of: `true`, `false`.

Example input: `{"contacts":[{"email":"jane@acme.example","firstName":"Jane"},{"email":"john@globex.example","firstName":"John"}],"list_id":"<list_id>"}`

### `emelia_list_create`

Create Contact List · Write

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.

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

Inputs:

- `name` (`string`, required): List name. Example: SaaS founders - US.

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

### `emelia_list_rename`

Rename Contact List · Write

Rename a contact list.
Returns the updated list.
Get the ID from emelia_lists_list.

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

Inputs:

- `list_id` (`string`, required): Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.
- `name` (`string`, required): New list name. Example: SaaS founders - US (Q1)

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

### `emelia_phone_find`

Find Phone Number · Write

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.

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

Inputs:

- `linkedin_url` (`string`, required): LinkedIn profile URL; must contain linkedin.com/in/. Example: https://www.linkedin.com/in/janedoe.

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

### `emelia_reply_send`

Send Reply from Mailbox · Write

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.

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

Inputs:

- `content` (`string`, required): HTML body. Use <br> for line breaks. Example: Hi Jane,<br>Thanks for getting back to me.
- `cc` (`array`, optional): CC email addresses. Example: ["boss@acme.example"]
- `message_id` (`string`, optional): Message-ID of the email being answered, to thread the reply. Example: <CAF1234@mail.gmail.com>.
- `provider_id` (`string`, optional): Sending mailbox ID, from emelia_email_providers_list (or give sender_email). Example: 6650f1a2b839d80011c5a0aa.
- `scheduled_at` (`string`, optional): Send later at this ISO 8601 time. Example: 2026-02-02T09:00:00Z.
- `sender_email` (`string`, optional): Sending mailbox address (or give provider_id). Example: jane@mycompany.example.
- `subject` (`string`, optional): Subject. Needed when message_id is not given. Example: Re: Quick question.
- `to` (`array`, optional): Recipient email addresses. Needed when message_id is not given. Example: ["jane@acme.example"]

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

### `emelia_warmup_enable`

Enable Mailbox Warmup · Write

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.

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

Inputs:

- `provider_id` (`string`, required): Mailbox (email provider) ID or warmup ID. Example: 6650f1a2b839d80011c5a0aa.

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

### `emelia_webhook_create`

Create Campaign Webhook · Write

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.

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

Inputs:

- `campaign_id` (`string`, required): Campaign ID, or ALL_CAMPAIGNS. Example: 6650f1a2b839d80011c5a0f1.
- `events` (`array`, required): Events to receive, for example MAIL_REPLIED, LINKEDIN_REPLIED, SENT, OPENED, CLICKED, BOUNCED, UNSUBSCRIBED. Example: ["MAIL_REPLIED", "LINKEDIN_REPLIED"]
- `hook_url` (`string`, required): Public HTTPS URL that receives the events. Example: https://hooks.example.com/emelia/9f2c4e1a7b.

Example input: `{"campaign_id":"<campaign_id>","events":["MAIL_REPLIED","LINKEDIN_REPLIED"],"hook_url":"<hook_url>"}`

### `emelia_blacklist_email_remove`

Remove Email from Blacklist · Destructive

Remove an email address or domain from the account blacklist.
Returns success.
Use emelia_blacklists_get to see current entries.

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

Inputs:

- `email` (`string`, required): Email address or bare domain to remove. Example: competitor.example.

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

### `emelia_campaign_contact_remove`

Remove Contact from Campaign · Destructive

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.

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

Inputs:

- `campaign_id` (`string`, required): Campaign ID. Example: 6650f1a2b839d80011c5a0f1.
- `contact_id` (`string`, required): Contact ID (24 hex characters), from emelia_campaign_contacts_list. Example: 65f1a2b3c4d5e6f74db757ce.

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

### `emelia_campaign_delete`

Delete Campaign · Destructive

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.

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

Inputs:

- `campaign_id` (`string`, required): Multichannel campaign ID (24 hex characters), from emelia_campaigns_list. Example: 6650f1a2b839d80011c5a0f1.

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

### `emelia_list_contact_delete`

Delete List Contact · Destructive

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.

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

Inputs:

- `contact_id` (`string`, required): Contact ID (leadId), from emelia_list_contacts_list. Example: 65f1a2b3c4d5e6f7af1c3d42.
- `list_id` (`string`, required): Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.

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

### `emelia_list_delete`

Delete Contact List · Destructive

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.

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

Inputs:

- `list_id` (`string`, required): Contact list ID (24 hex characters), from emelia_lists_list. Example: 65f1a2b3c4d5e6f760f68df4.

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

### `emelia_webhook_delete`

Delete Campaign Webhook · Destructive

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.

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

Inputs:

- `campaign_id` (`string`, required): Campaign ID, or ALL_CAMPAIGNS. Example: 6650f1a2b839d80011c5a0f1.
- `hook_url` (`string`, required): The URL exactly as registered. Example: https://hooks.example.com/emelia/9f2c4e1a7b.

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

## Related

Other CRM & Sales connectors ([all 174](/agentkit/connectors/?category=crm-sales)):

- [Salesforce](/agentkit/connectors/salesforce/): Scalekit connector, OAuth, 74 tools
- [HubSpot](/agentkit/connectors/hubspot/): Scalekit connector, OAuth, 457 tools
- [Close](/agentkit/connectors/close/): Scalekit connector, OAuth, 103 tools


---

## More Scalekit documentation

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