# Emelia

Emelia is an all-in-one B2B prospecting tool offering features like cold-emailing, LinkedIn outreach, email warm-up, email finder, and LinkedIn Sales Navigator scraping.

- **Category:** drip emails
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 22
- **Triggers:** 0
- **Slug:** `EMELIA`
- **Version:** 20260309_00

## Tools

### Add Contact to Blacklist

**Slug:** `EMELIA_ADD_CONTACT_TO_BLACKLIST`

Tool to add a contact to the email blacklist. Use after confirming that no further emails should be sent to a specific address. Example: 'Add blocked_user@example.com to blacklist.'

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address of the contact to be blacklisted. |

#### Output

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

### Add Contact To Campaign

**Slug:** `EMELIA_ADD_CONTACT_TO_CAMPAIGN`

Tool to add a contact to an email campaign. Use when you have collected subscriber details and want to enroll them in a campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Campaign ID to which the contact will be added |
| `contact` | object | Yes | Contact object containing email and optional name/fields |

#### Output

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

### Create Campaign

**Slug:** `EMELIA_CREATE_CAMPAIGN`

Tool to create a new email campaign. Use after you have finalized the campaign name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the email campaign |

#### Output

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

### Create LinkedIn Campaign

**Slug:** `EMELIA_CREATE_LINKEDIN_CAMPAIGN`

Tool to create a new LinkedIn campaign. Use when you need to launch a LinkedIn outreach sequence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the LinkedIn campaign to create |

#### Output

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

### Create Webhook

**Slug:** `EMELIA_CREATE_WEBHOOK`

Tool to create a new webhook for campaign events. Use when you need to subscribe to activity updates after determining the campaign ID and desired events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("linkedin" | "email" | "advanced") | Yes | The type of campaign the webhook is for. |
| `events` | array | Yes | List of events to subscribe to. For linkedin: VISITED, INVITED, ACCEPTED, MESSAGE_SENT, REPLIED; for email: REPLIED, OPENED, CLICKED, SENT, BOUNCED, UNSUBSCRIBED; for advanced: MAIL_REPLIED, OPENED, CLICKED, MAIL_SENT, BOUNCED, UNSUBSCRIBED, LINKEDIN_REPLIED, VISITED, ACCEPTED, MESSAGE_SENT, LIKED. |
| `hookUrl` | string | Yes | The destination URL for the webhook payloads. |
| `campaignId` | string | Yes | The ID of the campaign to attach the webhook to (use 'ALL_CAMPAIGNS' for all campaigns) |

#### Output

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

### Delete Contact From Campaign

**Slug:** `EMELIA_DELETE_CONTACT_FROM_CAMPAIGN`

Tool to remove a contact from an email campaign. Use when you need to revoke a contact's subscription from a specific campaign. Note: this operation is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | string | Yes | The ID of the contact to remove from the campaign. |
| `campaign_id` | string | Yes | The ID of the campaign from which to remove the contact. |

#### Output

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

### Delete Contact From LinkedIn Campaign

**Slug:** `EMELIA_DELETE_CONTACT_FROM_LINKEDIN_CAMPAIGN`

Tool to delete a contact from a LinkedIn campaign. Use when you need to remove a contact by campaign ID and contact URL. Call after confirming the contact exists in the campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the LinkedIn campaign. |
| `url` | string | Yes | The LinkedIn profile URL of the contact to remove. |

#### Output

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

### Delete Webhook

**Slug:** `EMELIA_DELETE_WEBHOOK`

Tool to delete a specific webhook. Use when you need to remove an existing webhook by URL after identifying the campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("linkedin" | "email" | "advanced") | No | The type of campaign the webhook is attached to. Possible values: linkedin, email, advanced. |
| `hookUrl` | string | Yes | The exact URL of the webhook to delete. |
| `campaignId` | string | Yes | The campaign ID to delete the webhook from (use 'ALL_CAMPAIGNS' for all campaigns). |

#### Output

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

### Find Email of Single Contact

**Slug:** `EMELIA_FIND_EMAIL_SINGLE_CONTACT`

Tool to initiate a job to find the email address of a specific contact. Use when you have the contact's full name and company details and want to retrieve their email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `country` | string | Yes | Country of the contact or company (ISO 3166-1 alpha-2 code or name). |
| `fullname` | string | Yes | Full name of the contact to find (e.g., 'John Doe'). |
| `companyName` | string | Yes | Name of the contact's company (e.g., 'Acme Corp'). |
| `companyWebsite` | string | No | Website of the contact's company (e.g., 'https://acme.com'). |

#### Output

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

### Get Campaign Activities

**Slug:** `EMELIA_GET_CAMPAIGN_ACTIVITIES`

Tool to retrieve activities for a specific email campaign. Use after obtaining the campaign ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based index) |
| `type` | string ("SENT" | "FIRST_OPEN" | "OPENED" | "CLICKED" | "REPLIED" | "RE_REPLY" | "BOUNCED" | "UNSUBSCRIBED") | No | Filter activities by event type |
| `query` | string | No | Free-text search across activities |
| `contactId` | string | No | Filter activities by a specific contact ID |
| `versionId` | string | No | Filter activities by a specific campaign version ID |
| `campaignId` | string | Yes | ID of the campaign to retrieve activities for |

#### Output

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

### Get Find Email Result

**Slug:** `EMELIA_GET_FIND_EMAIL_RESULT`

Tool to retrieve the result of a previously initiated email find job. Use after initiating a find-email job to check its status and outcome.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `jobId` | string | Yes | The ID of the find-email job to retrieve the result for. |

#### Output

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

### Get Find Phone Result

**Slug:** `EMELIA_GET_FIND_PHONE_RESULT`

Tool to retrieve the outcome of a previously initiated phone-find job. Use after starting a job to fetch its status and details by job ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `job_id` | string | Yes | ID of the phone-find job to get the result for |

#### Output

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

### Get Campaign Activities

**Slug:** `EMELIA_GET_LINKEDIN_CAMPAIGN_ACTIVITIES`

Tool to retrieve activities for a campaign. Use when you need to inspect engagement events for a specific campaign.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (must be >= 1). |
| `per_page` | integer | No | Number of items per page (must be >= 1). |
| `campaign_id` | string | Yes | The ID of the LinkedIn campaign to retrieve activities for. |

#### Output

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

### Get Verify Email Result

**Slug:** `EMELIA_GET_VERIFY_EMAIL_RESULT`

Tool to get the result of an email verification job. Use after initiating an email verification job to check its status and outcome.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `jobId` | string | Yes | ID of the email verification job to get the result for |

#### Output

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

### Initiate Email Verification Job

**Slug:** `EMELIA_INITIATE_EMAIL_VERIFICATION_JOB`

Tool to initiate an asynchronous email verification job."

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | The email address to verify asynchronously. |

#### Output

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

### Initiate Phone Find Job

**Slug:** `EMELIA_INITIATE_PHONE_FIND_JOB`

Tool to initiate a phone-find job for a single contact. Use when you want to retrieve a contact's phone number based on their email address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `linkedinUrl` | string | Yes | LinkedIn profile URL of the contact for which to find the phone number. |

#### Output

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

### List Campaign Contacts

**Slug:** `EMELIA_LIST_CAMPAIGN_CONTACTS`

Tool to list contacts in a specific email campaign. Use when you need to retrieve campaign subscribers with optional pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based index). Defaults to 1. |
| `campaignId` | string | Yes | Unique identifier of the email campaign. |

#### Output

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

### List Campaigns

**Slug:** `EMELIA_LIST_CAMPAIGNS`

Tool to retrieve all email campaigns. Use when you need to fetch the list of campaigns, with optional pagination or search filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (1-based index) |
| `limit` | integer | No | Number of items per page |
| `search` | string | No | Search string to filter campaigns by name or attributes |

#### Output

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

### List Email Providers

**Slug:** `EMELIA_LIST_EMAIL_PROVIDERS`

Tool to retrieve all configured email providers. Use after setting up your email providers to view them.

#### Output

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

### List LinkedIn Campaigns

**Slug:** `EMELIA_LIST_LINKEDIN_CAMPAIGNS`

Tool to list all LinkedIn campaigns. Use when you need an overview of your LinkedIn campaigns and want to paginate results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (must be >= 1). |
| `per_page` | integer | No | Number of items per page (must be >= 1). |

#### Output

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

### List webhooks

**Slug:** `EMELIA_LIST_WEBHOOKS`

Tool to retrieve all webhooks. Use when you need to fetch every configured webhook in Emelia.

#### Output

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

### Remove Contact from Blacklist

**Slug:** `EMELIA_REMOVE_CONTACT_FROM_BLACKLIST`

Tool to remove a contact or domain from the email blacklist. Use after verifying that the address or domain should no longer be blocked.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_or_domain` | string | Yes | The email address or domain to remove from the blacklist. |

#### Output

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