# Amplemarket

> Find sales contacts and companies, manage lead lists, and look up outreach activity.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/amplemarket

## Actions

### Add leads to list

Add leads to list in Amplemarket.

**Inputs**

- Lead list (`lead_list_id`, text, required): Lead List id.
- Type (`type`, text): Type. One of: `linkedin`, `email`, `titles_and_company` (Titles and company).
- Leads (`leads`, list, required): Leads.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "total": 1,
    "total_added_to_lead_list": 1
  }
}
```

### Create contact

Create contact in Amplemarket.

**Inputs**

- Email (`email`, text, required): Contact email.
- First name (`first_name`, text): Contact first name.
- Last name (`last_name`, text): Contact last name.
- Title (`title`, text): Contact job title.
- City (`city`, text): Contact city.
- State (`state`, text): Contact state or region.
- Country (`country`, text): Contact country.
- Industry (`industry`, text): Contact industry.
- Linkedin URL (`linkedin_url`, text): Contact LinkedIn profile URL.
- Owner email (`owner_email`, text): Email of the Amplemarket user that should own the contact.
- Account (`account_id`, text): Prospect Hub account public ID to associate to the contact.
- Crm account ID (`crm_account_id`, text): CRM account identifier used to resolve the Prospect Hub account association.
- Company domain (`company_domain`, text): Company domain used to resolve the Prospect Hub account association.
- Company name (`company_name`, text): Company name used as a fallback to resolve the Prospect Hub account association.
- Phone numbers (`phone_numbers`, list): Phone numbers to attach to the contact as user-uploaded numbers.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "company_domain": "example",
    "company_name": "example",
    "created_at": "example",
    "crm": {
      "contact_name": "example",
      "contact_url": "example",
      "id": "example",
      "owner": {
        "email": "example",
        "name": "example"
      },
      "provider": "salesforce",
      "type": "contact"
    },
    "email": "example",
    "first_name": "example",
    "id": "example",
    "last_contacted_at": "example",
    "last_name": "example",
    "linkedin_url": "example",
    "location": "example",
    "name": "example",
    "owner": "example",
    "phone_numbers": [],
    "recent_activity": [],
    "time_zone": "example",
    "title": "example"
  }
}
```

### Create lead list

Create lead list in Amplemarket.

**Inputs**

- Name (`name`, text): Name.
- Shared (`shared`, true/false, required): Shared.
- Visible (`visible`, true/false): Visible.
- Owner (`owner`, text, required): Owner.
- Type (`type`, text, required): Type. One of: `linkedin`, `email`, `titles_and_company` (Titles and company).
- Options (`options`, object): Options.
- Leads (`leads`, list, required): You may send up to 10000 leads at a time.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_errors": [],
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "created_at": "example",
    "id": "example",
    "leads": [],
    "name": "example",
    "object": "lead_list",
    "options": {
      "enrich": false,
      "reveal_phone_numbers": false,
      "validate_email": false
    },
    "owner": "example",
    "shared": false,
    "status": "queued",
    "type": "linkedin",
    "updated_at": "example",
    "url": "example",
    "visible": false
  }
}
```

### Find company

Find company in Amplemarket.

**Inputs**

- Domain (`domain`, text): Domain to use for matching.
- Linkedin URL (`linkedin_url`, text): LinkedIn URL to use for matching.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "department_headcount": {},
    "estimated_number_of_employees": 1,
    "estimated_revenue": "$0-$1M",
    "followers": 1,
    "founded_year": 1,
    "id": "example",
    "is_b2b": false,
    "is_b2c": false,
    "job_function_headcount": {},
    "keywords": [],
    "latest_funding_date": "example",
    "latest_funding_stage": "seed",
    "linkedin_presence": "massive",
    "linkedin_url": "example",
    "location": "example",
    "location_details": {
      "city": "example",
      "country": "example",
      "lat": 1.0,
      "long": 1.0,
      "postal_code": "example",
      "state": "example"
    },
    "locations": [],
    "logo_url": "example",
    "naics_codes": [],
    "name": "example",
    "object": "company",
    "overview": "example",
    "revenue": 1,
    "sic_codes": [],
    "size": "10001+ employees",
    "technologies": [],
    "total_funding": 1,
    "traffic_rank": 1,
    "type": "Public Company",
    "website": "example"
  }
}
```

### Get account

Retrieve account from Amplemarket.

**Inputs**

- Account (`account_id`, text, required): Account public ID.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "crm": {
      "account_name": "example",
      "account_url": "example",
      "owner": {
        "email": "example",
        "name": "example"
      },
      "provider": "example"
    },
    "custom_fields": {},
    "description": "example",
    "domain": "example",
    "engagement": {
      "active_contacts_count": 1,
      "calls_made": 1,
      "calls_received": 1,
      "contacts_count": 1,
      "emails_received": 1,
      "emails_sent": 1,
      "first_contacted_at": "example",
      "interested_contacts_count": 1,
      "last_contacted_at": "example",
      "last_engaged_at": "example",
      "linkedin_received": 1,
      "linkedin_sent": 1,
      "meetings": 1
    },
    "founded_year": 1,
    "id": "example",
    "image_url": "example",
    "industry": "example",
    "insights": "example",
    "insights_generated_at": "example",
    "insights_status": "example",
    "latest_completed_research": {
      "generated_at": "example",
      "relevance": "high",
      "signals": [],
      "summary": "example"
    },
    "linkedin_url": "example",
    "location": {
      "city": "example",
      "country": "example",
      "state": "example"
    },
    "name": "example",
    "opportunities": {
      "closed_count": 1,
      "open_count": 1,
      "total_closed_amount": 1.0,
      "total_open_amount": 1.0
    },
    "owner": {
      "email": "example",
      "name": "example"
    },
    "research_status": "none",
    "size": "example",
    "tags": []
  }
}
```

### Get account info

Retrieve account info from Amplemarket.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "id": "example",
    "name": "example"
  }
}
```

### Get contact

Retrieve contact from Amplemarket.

**Inputs**

- Contact (`contact_id`, text, required): Contact id.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "company_domain": "example",
    "company_name": "example",
    "created_at": "example",
    "crm": {
      "contact_name": "example",
      "contact_url": "example",
      "id": "example",
      "owner": {
        "email": "example",
        "name": "example"
      },
      "provider": "salesforce",
      "type": "contact"
    },
    "email": "example",
    "first_name": "example",
    "id": "example",
    "last_contacted_at": "example",
    "last_name": "example",
    "linkedin_url": "example",
    "location": "example",
    "name": "example",
    "owner": "example",
    "phone_numbers": [],
    "recent_activity": [],
    "time_zone": "example",
    "title": "example"
  }
}
```

### Get contact by email

Retrieve contact by email from Amplemarket.

**Inputs**

- Email (`email`, text, required): Contact email.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "company_domain": "example",
    "company_name": "example",
    "created_at": "example",
    "crm": {
      "contact_name": "example",
      "contact_url": "example",
      "id": "example",
      "owner": {
        "email": "example",
        "name": "example"
      },
      "provider": "salesforce",
      "type": "contact"
    },
    "email": "example",
    "first_name": "example",
    "id": "example",
    "last_contacted_at": "example",
    "last_name": "example",
    "linkedin_url": "example",
    "location": "example",
    "name": "example",
    "owner": "example",
    "phone_numbers": [],
    "recent_activity": [],
    "time_zone": "example",
    "title": "example"
  }
}
```

### Get lead list

Retrieve lead list from Amplemarket.

**Inputs**

- Lead list (`lead_list_id`, text, required): Lead List id.
- Page size (`page_size`, text): Page size.
- Page after (`page_after`, text): Page after.
- Page before (`page_before`, text): Page before.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_errors": [],
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "created_at": "example",
    "id": "example",
    "leads": [],
    "name": "example",
    "object": "lead_list",
    "options": {
      "enrich": false,
      "reveal_phone_numbers": false,
      "validate_email": false
    },
    "owner": "example",
    "shared": false,
    "status": "queued",
    "type": "linkedin",
    "updated_at": "example",
    "url": "example",
    "visible": false
  }
}
```

### List accounts

Retrieve a page of accounts from Amplemarket.

**Inputs**

- Name (`name`, text): Filter accounts by name (case-insensitive partial match).
- Domain (`domain`, text): Filter accounts by domain (exact match).
- Owner email (`owner_email`, text): Filter accounts by owner email (exact match).
- Tags (`tags`, list): Filter accounts by tag names.
- Page after (`page_after`, text): Cursor for next page (from _links.next).
- Page size (`page_size`, number): Page size (default: 10, max: 50).

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "accounts": []
  }
}
```

### List call dispositions

Retrieve a page of call dispositions from Amplemarket.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "dispositions": []
  }
}
```

### List calls

Retrieve a page of calls from Amplemarket.

**Inputs**

- Page size (`page_size`, text): Page size.
- Page after (`page_after`, text): Page after.
- Page before (`page_before`, text): Page before.
- Member (`member_id`, text): Filter by user ID.
- From number (`from_number`, text): Filter by call from number.
- To (`to`, text): Filter by call to number.
- Direction (`direction`, text): Filter by call direction. One of: `incoming`, `outgoing`.
- Start date from (`start_date_from`, date and time): Select calls starting after this date (ISO 8601 format).
- Start date to (`start_date_to`, date and time): Select calls starting before this date (ISO 8601 format).

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "calls": []
  }
}
```

### List contacts

Retrieve a page of contacts from Amplemarket.

**Inputs**

- Name (`name`, text): Optional contact name filter. Use with or without account_id as an alternative to ids[].
- Account (`account_id`, text): Optional Prospect Hub account public ID filter. Use with or without name as an alternative to ids[].
- Ids (`ids`, list): Optional contact ID filter (maximum of 20 ids). Use ids[] or name/account_id filters.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "contacts": []
  }
}
```

### List lead lists

Retrieve a page of lead lists from Amplemarket.

**Inputs**

- Page size (`page_size`, text): Page size.
- Page after (`page_after`, text): Page after.
- Page before (`page_before`, text): Page before.
- Status (`status`, text): Filter by lead list status.
- Owner ID (`owner_id`, text): Filter by lead list owner id.
- Owner email (`owner_email`, text): Filter by lead list owner email.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "lead_lists": []
  }
}
```

### List mailboxes

Retrieve a page of mailboxes from Amplemarket.

**Inputs**

- Page size (`page_size`, text): Page size (max 20).
- Page after (`page_after`, text): Page after.
- Page before (`page_before`, text): Page before.
- Status (`status`, text): Filter by mailbox status. One of: `active`, `inactive`, `needs_reconnection` (Needs reconnection).
- Email provider (`email_provider`, text): Filter by email provider. One of: `google`, `outlook`, `other`, `other_mixed` (Other mixed).
- User email (`user_email`, text): Filter by user email.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "mailboxes": []
  }
}
```

### List sequences

Retrieve a page of sequences from Amplemarket.

**Inputs**

- Page size (`page_size`, text): Page size.
- Page after (`page_after`, text): Page after.
- Page before (`page_before`, text): Page before.
- Status (`status`, text): Filter by sequence status.
- Created by user ID (`created_by_user_id`, text): Filter by sequence creator id.
- Created by user email (`created_by_user_email`, text): Filter by sequence creator email.
- Name (`name`, text): Search by sequence name (case insensitive).

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "sequences": []
  }
}
```

### List tasks

Retrieve a page of tasks from Amplemarket.

**Inputs**

- Page size (`page_size`, text): Page size.
- Page after (`page_after`, text): Page after.
- Page before (`page_before`, text): Page before.
- Automatic (`automatic`, true/false): Filter by task automation type.
- Type (`type`, text): Filter by task type.
- Status (`status`, text): Filter by task status.
- Message opens (`message_opens`, number): Filter by associated message opens. At least 0.
- Keyword (`keyword`, text): Filter by name, email or company associated with task.
- Sequence key (`sequence_key`, text): Filter by associated sequence.
- Member (`member_id`, text, required): Filter by user.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "tasks": []
  }
}
```

### List users

Retrieve a page of users from Amplemarket.

**Inputs**

- Page size (`page_size`, text): Page size.
- Page after (`page_after`, text): Page after.
- Page before (`page_before`, text): Page before.
- Status (`status`, text): Filter by user status.
- Role (`role`, text): Filter by user role.
- Email (`email`, text): Filter by user email.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_links": {
      "next": {
        "href": "example"
      },
      "prev": {
        "href": "example"
      },
      "self": {
        "href": "example"
      }
    },
    "users": []
  }
}
```

### Search companies

Search companies in Amplemarket.

**Inputs**

- Company names (`company_names`, list): Company names.
- Company exclude names (`company_exclude_names`, list): Company exclude names.
- Company ids (`company_ids`, list): Company ids.
- Company exclude ids (`company_exclude_ids`, list): Company exclude ids.
- Company locations (`company_locations`, list): Company locations.
- Company exclude locations (`company_exclude_locations`, list): Company exclude locations.
- Company domains (`company_domains`, list): Company domains.
- Company exclude domains (`company_exclude_domains`, list): Company exclude domains.
- Company linkedin urls (`company_linkedin_urls`, list): Company linkedin urls.
- Company exclude linkedin urls (`company_exclude_linkedin_urls`, list): Company exclude linkedin urls.
- Company domains match subsidiaries and affiliates (`company_domains_match_subsidiaries_and_affiliates`, true/false): Company domains match subsidiaries and affiliates.
- Company focuses (`company_focuses`, list): Company focuses. One or more of: `b2b`, `b2c`.
- Company types (`company_types`, list): Company types. One or more of: `Public Company`, `Educational`, `Self Employed`, `Government Agency`, `Non Profit`, `Self Owned`, `Privately Held`, `Partnership`.
- Company sizes (`company_sizes`, list): Company sizes. One or more of: `1-10 employees`, `11-50 employees`, `51-200 employees`, `201-500 employees`, `501-1000 employees`, `1001-5000 employees`, `5001-10000 employees`, `10001+ employees`.
- Company industries (`company_industries`, list): Available options: [Supported industries](/api-reference/supported-industries).
- Company exclude industries (`company_exclude_industries`, list): Available options: [Supported industries](/api-reference/supported-industries).
- Company investors (`company_investors`, list): Array of investor names. Filter for companies that have received investment by any of the specified investors.
- Company shares investors with (`company_shares_investors_with`, list): Array of company names. Filter for companies that share one or more common investors with the specified companies.
- Company keywords (`company_keywords`, list): Keywords to search in the company description. Matches any keyword by default.
- Company exclude keywords (`company_exclude_keywords`, list): Keywords to exclude from the company description.
- Company revenue (`company_revenue`, list): Filter by estimated revenue range. One or more of: `$0-$1M`, `$1M-$10M`, `$10M-$100M`, `$100M-$1B`, `$1B+`.
- Company founded date (`company_founded_date`, object): Filter by founding year range.
- Company web traffic rank (`company_web_traffic_rank`, object): Filter by web traffic rank. Lower rank means more traffic.
- Job openings (`job_openings`, object): Filter by companies with matching open positions.
- News (`news`, object): Filter by recent company news.
- Headcount growth (`headcount_growth`, object): Filter by total headcount growth percentage over a time period.
- Crm account owner (`crm_account_owner`, list): Filter by CRM account owner emails. Requires a connected CRM integration (Salesforce or HubSpot). Returns an error if no owners match the provided emails.
- Company last funding (`company_last_funding`, object): Filter by last funding round.
- Company linkedin presence (`company_linkedin_presence`, list): Company linkedin presence. One or more of: `large`, `limited`, `massive`, `moderate`, `none`.
- Page (`page`, number): Page.
- Page size (`page_size`, number): Number of results per page. Values greater than 50 are accepted and capped at 50. At least 1.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_errors": [],
    "_pagination": {
      "page": 1,
      "page_size": 1,
      "total": 1,
      "total_pages": 1
    },
    "object": "company_search_result",
    "results": []
  }
}
```

### Search people

Search people in Amplemarket.

**Inputs**

- Person name (`person_name`, text): Person name.
- Person titles (`person_titles`, list): Person titles.
- Person keywords (`person_keywords`, list): Keywords to search in the person's profile summary (headline, about, etc.). Matches any keyword by default.
- Person exclude keywords (`person_exclude_keywords`, list): Keywords to exclude from the person's profile summary.
- Company keywords (`company_keywords`, list): Keywords to search in the person's company description. Matches any keyword by default.
- Company exclude keywords (`company_exclude_keywords`, list): Keywords to exclude from the person's company description.
- Person title exact match (`person_title_exact_match`, true/false): Person title exact match.
- Person seniorities (`person_seniorities`, list): Person seniorities. One or more of: `Owner`, `Founder`, `C-Suite`, `Partner`, `VP`, `Head`, `Director`, `Manager`, `Senior`, `Entry`, and 4 more.
- Person departments (`person_departments`, list): Available options: [Supported departments](/api-reference/supported-departments).
- Person job functions (`person_job_functions`, list): Available options: [Supported job functions](/api-reference/supported-job-functions).
- Person locations (`person_locations`, list): Person locations.
- Person exclude locations (`person_exclude_locations`, list): Person exclude locations.
- Company locations (`company_locations`, list): Company locations.
- Company exclude locations (`company_exclude_locations`, list): Company exclude locations.
- Company names (`company_names`, list): Company names.
- Company exclude names (`company_exclude_names`, list): Company exclude names.
- Company ids (`company_ids`, list): Company ids.
- Company exclude ids (`company_exclude_ids`, list): Company exclude ids.
- Education company ids (`education_company_ids`, list): Education company ids.
- Education company names (`education_company_names`, list): Education company names.
- Company domains (`company_domains`, list): Company domains.
- Company exclude domains (`company_exclude_domains`, list): Company exclude domains.
- Company linkedin urls (`company_linkedin_urls`, list): Company linkedin urls.
- Company exclude linkedin urls (`company_exclude_linkedin_urls`, list): Company exclude linkedin urls.
- Company domains match subsidiaries and affiliates (`company_domains_match_subsidiaries_and_affiliates`, true/false): Company domains match subsidiaries and affiliates.
- Company focuses (`company_focuses`, list): Company focuses. One or more of: `b2b`, `b2c`.
- Company types (`company_types`, list): Company types. One or more of: `Public Company`, `Educational`, `Self Employed`, `Government Agency`, `Non Profit`, `Self Owned`, `Privately Held`, `Partnership`.
- Company sizes (`company_sizes`, list): Company sizes. One or more of: `1-10 employees`, `11-50 employees`, `51-200 employees`, `201-500 employees`, `501-1000 employees`, `1001-5000 employees`, `5001-10000 employees`, `10001+ employees`.
- Company industries (`company_industries`, list): Available options: [Supported industries](/api-reference/supported-industries).
- Company exclude industries (`company_exclude_industries`, list): Available options: [Supported industries](/api-reference/supported-industries).
- Linkedin networks (`linkedin_networks`, list): Linkedin networks.
- Exclude linkedin networks (`exclude_linkedin_networks`, list): Exclude linkedin networks.
- Company investors (`company_investors`, list): Array of investor names. Filter for companies that have received investment by any of the specified investors.
- Company shares investors with (`company_shares_investors_with`, list): Array of company names. Filter for companies that share one or more common investors with the specified companies.
- Company revenue (`company_revenue`, list): Filter by the person's company estimated revenue range. One or more of: `$0-$1M`, `$1M-$10M`, `$10M-$100M`, `$100M-$1B`, `$1B+`.
- Company founded date (`company_founded_date`, object): Filter by the person's company founding year range.
- Company web traffic rank (`company_web_traffic_rank`, object): Filter by the person's company web traffic rank.
- Job openings (`job_openings`, object): Filter by the person's company having matching open positions.
- News (`news`, object): Filter by the person's company having recent news.
- Headcount growth (`headcount_growth`, object): Filter by the person's company total headcount growth percentage.
- Crm account owner (`crm_account_owner`, list): Filter by the person's company CRM account owner emails. Requires a connected CRM integration (Salesforce or HubSpot). Returns an error if no owners match the provided emails.
- Company last funding (`company_last_funding`, object): Filter by the person's company last funding round.
- Person linkedin presence (`person_linkedin_presence`, list): Person linkedin presence. One or more of: `influencer`, `large`, `limited`, `micro_influencer` (Micro influencer), `moderate`, `none`.
- Company linkedin presence (`company_linkedin_presence`, list): Company linkedin presence. One or more of: `large`, `limited`, `massive`, `moderate`, `none`.
- Page (`page`, number): Page.
- Page size (`page_size`, number): Number of results per page. Values greater than 100 are accepted and capped at 100. At least 1.

**Outputs**

- `data` (object): The result returned by Amplemarket.

**Example output**

```json
{
  "data": {
    "_errors": [],
    "_pagination": {
      "page": 1,
      "page_size": 1,
      "total": 1,
      "total_pages": 1
    },
    "object": "person_search_result",
    "results": []
  }
}
```
