Skip to content
Scalekit Docs
Talk to an EngineerDashboard

Amplemarket connector

Bearer TokenCRM & SalesMarketing

Connect to Amplemarket, an AI-powered sales engagement platform, to search and enrich B2B leads, manage email/LinkedIn outreach sequences, and score...

Amplemarket connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Make your first call

    Section titled “Make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

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

    const connector = 'amplemarket'
    const identifier = 'user_123'
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'amplemarket_account_info_get',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • List users, tasks types, tasks statuses — List users in the authenticated Amplemarket workspace, with optional filtering by status, role, or email, and cursor-based pagination
  • Skip task — Skip an Amplemarket task by its ID
  • Complete task — Mark an Amplemarket task as complete by its ID
  • Leads sequence add — Add one or more leads to an existing outreach sequence identified by its ID
  • Review phone number — Submit a data-quality review for a phone number in Amplemarket, flagging it as incorrect (e.g
  • Find person, company — Synchronously find and enrich a single person in the Amplemarket database by email, LinkedIn URL, or name plus company

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

amplemarket_account_get#Retrieve a single target account (company) by its Amplemarket public ID. Returns the account's name, domain, LinkedIn URL, description, industry, size, founded year, location, owner, tags, CRM data, opportunities, and engagement info. Returns a 404 error if the account ID does not exist.1 param

Retrieve a single target account (company) by its Amplemarket public ID. Returns the account's name, domain, LinkedIn URL, description, industry, size, founded year, location, owner, tags, CRM data, opportunities, and engagement info. Returns a 404 error if the account ID does not exist.

NameTypeRequiredDescription
idstringrequiredThe public ID of the account (target company) to retrieve.
amplemarket_account_info_get#Get basic information about the authenticated Amplemarket workspace, identified by the API key used to authenticate. Returns the workspace's account ID and display name. Useful for verifying which workspace an API key belongs to.0 params

Get basic information about the authenticated Amplemarket workspace, identified by the API key used to authenticate. Returns the workspace's account ID and display name. Useful for verifying which workspace an API key belongs to.

amplemarket_accounts_list#List accounts (target companies) in the Amplemarket CRM, with optional filtering by name (case-insensitive partial match), domain (exact match), owner email (exact match), or tag names, and cursor-based pagination. Returns each account's ID, name, website, LinkedIn URL, owner email, and last contacted/engaged timestamps.6 params

List accounts (target companies) in the Amplemarket CRM, with optional filtering by name (case-insensitive partial match), domain (exact match), owner email (exact match), or tag names, and cursor-based pagination. Returns each account's ID, name, website, LinkedIn URL, owner email, and last contacted/engaged timestamps.

NameTypeRequiredDescription
domainstringoptionalFilter accounts by domain, using an exact match.
namestringoptionalFilter accounts by name using a case-insensitive partial match.
owner_emailstringoptionalFilter accounts by owner email address, using an exact match.
page_afterstringoptionalPagination cursor to fetch results after this point, taken from the previous response's next link.
page_sizeintegeroptionalNumber of results to return per page (default 10, max 50).
tagsarrayoptionalFilter accounts by tag names. Only accounts with at least one matching tag are returned.
amplemarket_call_create#Log a new call in Amplemarket, associating it with a user and a task. Requires the originating and destination phone numbers, call duration, whether the call was answered, whether a human answered, and the associated task and user IDs. Optionally include a transcription, recording URL, and disposition ID. If the given disposition has its action set to 'complete', the associated task will automatically be marked as completed.10 params

Log a new call in Amplemarket, associating it with a user and a task. Requires the originating and destination phone numbers, call duration, whether the call was answered, whether a human answered, and the associated task and user IDs. Optionally include a transcription, recording URL, and disposition ID. If the given disposition has its action set to 'complete', the associated task will automatically be marked as completed.

NameTypeRequiredDescription
answeredbooleanrequiredWhether the call was answered.
durationintegerrequiredLength of the call in seconds.
fromstringrequiredPhone number that initiated the call.
humanbooleanrequiredWhether a human answered the call, as opposed to a machine or voicemail.
task_idstringrequiredID of the Amplemarket task this call is associated with.
tostringrequiredPhone number that received the call.
user_idstringrequiredID of the Amplemarket user this call is associated with.
disposition_idstringoptionalID of the call disposition. If the given disposition has its action set to 'complete', the associated task will be marked as completed.
recording_urlstringoptionalURL to the call's audio recording.
transcriptionstringoptionalText transcription of the call audio.
amplemarket_call_dispositions_list#List the call disposition values available in the authenticated Amplemarket workspace. Each disposition represents an outcome that can be logged against a call (e.g. 'No Answer', 'Left VM', 'Not interested', 'Interested') and includes the disposition's ID, display name, slug, and the resulting action (e.g. 'next_stage' or 'complete'). This is a metadata lookup endpoint with no parameters.0 params

List the call disposition values available in the authenticated Amplemarket workspace. Each disposition represents an outcome that can be logged against a call (e.g. 'No Answer', 'Left VM', 'Not interested', 'Interested') and includes the disposition's ID, display name, slug, and the resulting action (e.g. 'next_stage' or 'complete'). This is a metadata lookup endpoint with no parameters.

amplemarket_call_recording_get#Retrieve the audio recording for a logged Amplemarket call by call ID. Returns the raw recording file (audio/mpeg). Only recordings with external=false can be retrieved through this endpoint; calls with external recordings will not be returned. This endpoint is rate-limited to 50 requests per hour. Returns a 404 if the call is not found, or a 413 if the recording file is too large.1 param

Retrieve the audio recording for a logged Amplemarket call by call ID. Returns the raw recording file (audio/mpeg). Only recordings with external=false can be retrieved through this endpoint; calls with external recordings will not be returned. This endpoint is rate-limited to 50 requests per hour. Returns a 404 if the call is not found, or a 413 if the recording file is too large.

NameTypeRequiredDescription
idstringrequiredThe unique identifier of the call whose recording should be retrieved.
amplemarket_calls_list#List logged calls in the Amplemarket workspace, with optional filtering by user, phone numbers, and start date range, plus cursor-based pagination. Returns each call's ID, from/to numbers, duration, start date, answered/human/external flags, transcription, recording URL, and associated user/task/contact.8 params

List logged calls in the Amplemarket workspace, with optional filtering by user, phone numbers, and start date range, plus cursor-based pagination. Returns each call's ID, from/to numbers, duration, start date, answered/human/external flags, transcription, recording URL, and associated user/task/contact.

NameTypeRequiredDescription
fromstringoptionalFilter calls by the originating phone number.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
start_date_fromstringoptionalFilter calls that started on or after this ISO 8601 date/time.
start_date_tostringoptionalFilter calls that started on or before this ISO 8601 date/time.
tostringoptionalFilter calls by the destination phone number.
user_idstringoptionalFilter calls by the ID of the user who made or received them.
amplemarket_companies_enrichment_cancel#Cancel a pending or in-progress batch company enrichment request in Amplemarket by its ID. This transitions the batch's status to 'canceled' rather than deleting it; the batch and any partial results remain retrievable. Returns a 400 if the batch has already finished, or a 404 if the batch ID does not exist.1 param

Cancel a pending or in-progress batch company enrichment request in Amplemarket by its ID. This transitions the batch's status to 'canceled' rather than deleting it; the batch and any partial results remain retrievable. Returns a 400 if the batch has already finished, or a 404 if the batch ID does not exist.

NameTypeRequiredDescription
idstringrequiredID of the batch company enrichment request to cancel.
amplemarket_companies_enrichment_get#Retrieve the status and results of a previously started batch company enrichment request by its batch ID. While the batch is still processing, 'status' will be 'queued' or 'processing'; once 'completed', each result includes a per-company status ('found', 'not_found', or 'pending') and the enriched company object (name, industry, location, employees, funding, technologies, headcount, etc.) when found. Returns a 404 error if the batch ID does not exist.4 params

Retrieve the status and results of a previously started batch company enrichment request by its batch ID. While the batch is still processing, 'status' will be 'queued' or 'processing'; once 'completed', each result includes a per-company status ('found', 'not_found', or 'pending') and the enriched company object (name, industry, location, employees, funding, technologies, headcount, etc.) when found. Returns a 404 error if the batch ID does not exist.

NameTypeRequiredDescription
idstringrequiredThe batch ID of the companies enrichment request to retrieve, as returned by amplemarket_companies_enrichment_start.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
amplemarket_companies_enrichment_start#Start an asynchronous batch enrichment request for a list of companies, each identified by domain or LinkedIn URL. At least one company object must be provided; empty arrays are rejected. Returns a batch request with an ID and a 'queued' status; poll amplemarket_companies_enrichment_get with that ID to retrieve results once processing completes.1 param

Start an asynchronous batch enrichment request for a list of companies, each identified by domain or LinkedIn URL. At least one company object must be provided; empty arrays are rejected. Returns a batch request with an ID and a 'queued' status; poll amplemarket_companies_enrichment_get with that ID to retrieve results once processing completes.

NameTypeRequiredDescription
companiesarrayrequiredArray of company objects to enrich. Each object may include domain and/or linkedin_url. At least one company object must be provided.
amplemarket_company_find#Synchronously find and enrich a single company in the Amplemarket database by domain or LinkedIn URL. At least one identifier (domain or linkedin_url) must be provided. Returns the matched company's profile (name, website, overview, size, industry, location, funding, headcount, technologies) or a not-found error if no match exists.2 params

Synchronously find and enrich a single company in the Amplemarket database by domain or LinkedIn URL. At least one identifier (domain or linkedin_url) must be provided. Returns the matched company's profile (name, website, overview, size, industry, location, funding, headcount, technologies) or a not-found error if no match exists.

NameTypeRequiredDescription
domainstringoptionalDomain of the company to match, e.g. example.com. Provide this or linkedin_url.
linkedin_urlstringoptionalLinkedIn company page URL to match against a company record. Provide this or domain.
amplemarket_contact_create#Create a new contact in the Amplemarket account's CRM (Prospect Hub). Requires an email address; all other fields (name, title, location, company, owner, CRM linkage, phone numbers) are optional.15 params

Create a new contact in the Amplemarket account's CRM (Prospect Hub). Requires an email address; all other fields (name, title, location, company, owner, CRM linkage, phone numbers) are optional.

NameTypeRequiredDescription
emailstringrequiredEmail address of the contact to create.
account_idstringoptionalProspect Hub account public ID (UUID) to associate this contact with.
citystringoptionalCity where the contact is located.
company_domainstringoptionalDomain of the contact's company.
company_namestringoptionalName of the contact's company.
countrystringoptionalCountry where the contact is located.
crm_account_idstringoptionalExternal CRM account identifier to associate this contact with.
first_namestringoptionalFirst name of the contact.
industrystringoptionalIndustry the contact operates in.
last_namestringoptionalLast name of the contact.
linkedin_urlstringoptionalLinkedIn profile URL of the contact.
owner_emailstringoptionalEmail of the Amplemarket user who should own this contact.
phone_numbersarrayoptionalArray of phone number objects to associate with the contact. Example: [{"number": "+14155551234", "kind": "mobile"}]
statestringoptionalState or region where the contact is located.
titlestringoptionalJob title of the contact.
amplemarket_contact_get#Retrieve a contact by its ID from the Amplemarket account's CRM (Prospect Hub), including profile details, phone numbers, and recent activity (sequence events, calls, etc.).1 param

Retrieve a contact by its ID from the Amplemarket account's CRM (Prospect Hub), including profile details, phone numbers, and recent activity (sequence events, calls, etc.).

NameTypeRequiredDescription
contact_idstringrequiredThe unique identifier of the contact to retrieve.
amplemarket_contact_get_by_email#Retrieve a single Amplemarket contact by their exact email address. Returns the contact's ID, name, LinkedIn URL, title, location, time zone, company name/domain, owner, last contacted timestamp, phone numbers, and recent activity (sequence and call events). Returns a 404 error if no contact with that email exists.1 param

Retrieve a single Amplemarket contact by their exact email address. Returns the contact's ID, name, LinkedIn URL, title, location, time zone, company name/domain, owner, last contacted timestamp, phone numbers, and recent activity (sequence and call events). Returns a 404 error if no contact with that email exists.

NameTypeRequiredDescription
emailstringrequiredThe exact email address of the contact to retrieve.
amplemarket_contacts_list#List contacts in the Amplemarket account's CRM (Prospect Hub). Optionally filter by up to 20 specific contact IDs, by name, and/or by an associated account ID. Returns an array of contact objects including name, email, LinkedIn URL, title, location, company, owner, and phone numbers.3 params

List contacts in the Amplemarket account's CRM (Prospect Hub). Optionally filter by up to 20 specific contact IDs, by name, and/or by an associated account ID. Returns an array of contact objects including name, email, LinkedIn URL, title, location, company, owner, and phone numbers.

NameTypeRequiredDescription
account_idstringoptionalFilter contacts by the Prospect Hub account's public ID (UUID).
idsarrayoptionalArray of contact IDs to filter by (maximum of 20 IDs).
namestringoptionalFilter contacts by name. Can be used with or without account_id.
amplemarket_email_validations_cancel#Cancel a pending or in-progress batch of email validations in Amplemarket by its ID. This transitions the batch's status to 'canceled' rather than deleting it; the batch and any partial results remain retrievable. Returns a 400 if the batch has already finished, or a 404 if the batch ID does not exist.1 param

Cancel a pending or in-progress batch of email validations in Amplemarket by its ID. This transitions the batch's status to 'canceled' rather than deleting it; the batch and any partial results remain retrievable. Returns a 400 if the batch has already finished, or a 404 if the batch ID does not exist.

NameTypeRequiredDescription
idstringrequiredID of the batch of email validations to cancel.
amplemarket_email_validations_get#Retrieve the status and results of a previously started batch email validation request by its batch ID. While the batch is still processing, 'status' will be 'queued' or 'processing'; once 'completed', each result includes the validated email, its result ('deliverable', 'risky', 'undeliverable', or 'unknown'), and whether the domain is a catch-all. Returns a 404 error if the batch ID does not exist.4 params

Retrieve the status and results of a previously started batch email validation request by its batch ID. While the batch is still processing, 'status' will be 'queued' or 'processing'; once 'completed', each result includes the validated email, its result ('deliverable', 'risky', 'undeliverable', or 'unknown'), and whether the domain is a catch-all. Returns a 404 error if the batch ID does not exist.

NameTypeRequiredDescription
idstringrequiredThe batch ID of the email validation request to retrieve, as returned by amplemarket_email_validations_start.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
amplemarket_email_validations_start#Start an asynchronous batch of email validations for a list of email addresses. Consumes validation credits per email. Returns a batch request with an ID and a 'queued' status; poll amplemarket_email_validations_get with that ID to retrieve results (deliverable, risky, undeliverable, or unknown) once processing completes.1 param

Start an asynchronous batch of email validations for a list of email addresses. Consumes validation credits per email. Returns a batch request with an ID and a 'queued' status; poll amplemarket_email_validations_get with that ID to retrieve results (deliverable, risky, undeliverable, or unknown) once processing completes.

NameTypeRequiredDescription
emailsarrayrequiredArray of email objects to validate, each containing an 'email' field with the address to validate.
amplemarket_excluded_domains_create#Add one or more domains to Amplemarket's excluded domains (suppression) list, preventing prospects at those domains from being targeted by future outreach. For each domain supplied, the API returns a status of 'success' (added), 'duplicated' (already on the list), or 'error' (processing failed).1 param

Add one or more domains to Amplemarket's excluded domains (suppression) list, preventing prospects at those domains from being targeted by future outreach. For each domain supplied, the API returns a status of 'success' (added), 'duplicated' (already on the list), or 'error' (processing failed).

NameTypeRequiredDescription
domainsarrayrequiredList of domains to add to the excluded domains (suppression) list.
amplemarket_excluded_domains_delete#Remove one or more domains from Amplemarket's excluded domains (suppression) list, re-allowing prospects at those domains to be targeted by future outreach. For each domain supplied, the API returns a status of 'success' (removed), 'not_found' (was not in the exclusion list), or 'unsupported' (the exclusion originated from a connected CRM and cannot be deleted via this endpoint).1 param

Remove one or more domains from Amplemarket's excluded domains (suppression) list, re-allowing prospects at those domains to be targeted by future outreach. For each domain supplied, the API returns a status of 'success' (removed), 'not_found' (was not in the exclusion list), or 'unsupported' (the exclusion originated from a connected CRM and cannot be deleted via this endpoint).

NameTypeRequiredDescription
domainsarrayrequiredList of domains to remove from the excluded domains (suppression) list.
amplemarket_excluded_domains_list#List domains on Amplemarket's excluded (suppression) list, with optional filtering by domain keyword and cursor-based pagination. Returns each excluded domain's source, date added, and the reason(s) it was excluded.4 params

List domains on Amplemarket's excluded (suppression) list, with optional filtering by domain keyword and cursor-based pagination. Returns each excluded domain's source, date added, and the reason(s) it was excluded.

NameTypeRequiredDescription
filter_domainstringoptionalFilter the excluded domains list by a domain keyword.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
amplemarket_excluded_emails_create#Add one or more email addresses to Amplemarket's excluded emails (suppression) list, preventing them from being targeted by future outreach. For each email supplied, the API returns a status of 'success' (added), 'duplicated' (already on the list), or 'error' (processing failed).1 param

Add one or more email addresses to Amplemarket's excluded emails (suppression) list, preventing them from being targeted by future outreach. For each email supplied, the API returns a status of 'success' (added), 'duplicated' (already on the list), or 'error' (processing failed).

NameTypeRequiredDescription
emailsarrayrequiredList of email addresses to add to the excluded emails (suppression) list.
amplemarket_excluded_emails_delete#Remove one or more email addresses from Amplemarket's excluded emails (suppression) list, re-allowing them to be targeted by future outreach. For each email supplied, the API returns a status of 'success' (removed), 'not_found' (was not in the exclusion list), or 'unsupported' (the exclusion originated from a connected CRM and cannot be deleted via this endpoint).1 param

Remove one or more email addresses from Amplemarket's excluded emails (suppression) list, re-allowing them to be targeted by future outreach. For each email supplied, the API returns a status of 'success' (removed), 'not_found' (was not in the exclusion list), or 'unsupported' (the exclusion originated from a connected CRM and cannot be deleted via this endpoint).

NameTypeRequiredDescription
emailsarrayrequiredList of email addresses to remove from the excluded emails (suppression) list.
amplemarket_excluded_emails_list#List email addresses on Amplemarket's excluded (suppression) list, with optional filtering by email keyword and cursor-based pagination. Returns each excluded email's source, date added, and the reason(s) it was excluded.4 params

List email addresses on Amplemarket's excluded (suppression) list, with optional filtering by email keyword and cursor-based pagination. Returns each excluded email's source, date added, and the reason(s) it was excluded.

NameTypeRequiredDescription
filter_emailstringoptionalFilter the excluded emails list by an email keyword.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
amplemarket_job_opening_get#Retrieve a single job opening discovered by Amplemarket by its ID. Returns the job opening's title, URL, location, first/last seen timestamps, seniorities, departments, job functions, description, associated company name/domain, salary, and contract types. Returns a 404 if the job opening is not found, or a 410 if it is no longer available.1 param

Retrieve a single job opening discovered by Amplemarket by its ID. Returns the job opening's title, URL, location, first/last seen timestamps, seniorities, departments, job functions, description, associated company name/domain, salary, and contract types. Returns a 404 if the job opening is not found, or a 410 if it is no longer available.

NameTypeRequiredDescription
idstringrequiredAmplemarket job opening ID to retrieve.
amplemarket_job_openings_list#List job openings that Amplemarket has discovered for a target company, with optional filtering by seniority, department, job function, and remote status. Requires at least one company identifier: company_id, domain, or linkedin_url. Returns the matched company plus a page of job openings (title, url, location, seniorities, departments, job functions) with cursor-based pagination links.9 params

List job openings that Amplemarket has discovered for a target company, with optional filtering by seniority, department, job function, and remote status. Requires at least one company identifier: company_id, domain, or linkedin_url. Returns the matched company plus a page of job openings (title, url, location, seniorities, departments, job functions) with cursor-based pagination links.

NameTypeRequiredDescription
company_idstringoptionalAmplemarket company identifier to look up job openings for.
domainstringoptionalCompany domain name to look up job openings for.
linkedin_urlstringoptionalCompany LinkedIn profile URL to look up job openings for.
only_remotebooleanoptionalWhether to only retrieve remote positions.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_sizestringoptionalNumber of results to return per page (default 10, max 100).
person_departmentsarrayoptionalFilter job openings by department.
person_job_functionsarrayoptionalFilter job openings by job function.
person_senioritiesarrayoptionalFilter job openings by seniority level.
amplemarket_lead_list_add_leads#Add one or more leads to an existing lead list (max 10,000 leads per request, 60,000 total per list). Depending on the list type, leads require a linkedin_url or email to be matched. Returns counts of leads submitted and added.3 params

Add one or more leads to an existing lead list (max 10,000 leads per request, 60,000 total per list). Depending on the list type, leads require a linkedin_url or email to be matched. Returns counts of leads submitted and added.

NameTypeRequiredDescription
lead_list_idstringrequiredThe unique identifier of the lead list to add leads to.
leadsarrayrequiredArray of leads to add to the list (max 10,000 items per request). Each lead's linkedin_url is required for linkedin-type lists, and email is required for email-type lists. Example: [{"email": "john.doe@example.com", "title": "CEO", "company_name": "Example Corp"}]
typestringoptionalType of leads being added, which determines the required lead identifier. Valid values: linkedin, email, titles_and_company.
amplemarket_lead_list_create#Create a new lead list in Amplemarket by uploading up to 10,000 leads at once. The list type determines which lead identifier is required: 'linkedin' lists require linkedin_url per lead, 'email' lists require email per lead, and 'titles_and_company' lists match by title plus company_name/company_domain. The list is processed asynchronously; poll the Get Lead List tool to check status.6 params

Create a new lead list in Amplemarket by uploading up to 10,000 leads at once. The list type determines which lead identifier is required: 'linkedin' lists require linkedin_url per lead, 'email' lists require email per lead, and 'titles_and_company' lists match by title plus company_name/company_domain. The list is processed asynchronously; poll the Get Lead List tool to check status.

NameTypeRequiredDescription
leadsarrayrequiredArray of leads to add to the list (max 10,000 items). Each lead's linkedin_url is required if type is 'linkedin'. Example: [{"email": "john.doe@example.com", "title": "CEO", "company_name": "Example Corp"}]
ownerstringrequiredEmail address of the Amplemarket user who will own this lead list.
sharedbooleanrequiredWhether the lead list is shared with the whole team.
typestringrequiredType of lead list, which determines how leads are matched. Valid values: linkedin, email, titles_and_company.
namestringoptionalName of the lead list. If left blank, defaults to 'Lead List created via API'.
optionsobjectoptionalOptional processing options. Example: {"reveal_phone_numbers": true, "validate_email": true, "enrich": true}.
amplemarket_lead_list_get#Retrieve a lead list by its ID, including its processing status (queued, processing, or completed), metadata, options, and the full array of leads with enrichment and email validation results.1 param

Retrieve a lead list by its ID, including its processing status (queued, processing, or completed), metadata, options, and the full array of leads with enrichment and email validation results.

NameTypeRequiredDescription
lead_list_idstringrequiredThe unique identifier of the lead list to retrieve.
amplemarket_lead_lists_list#List lead lists in the Amplemarket account. Supports cursor-based pagination and filtering by status, owner ID, or owner email. Returns an array of lead list summaries (id, name, status, url, shared, visible, owner, type) plus pagination links.6 params

List lead lists in the Amplemarket account. Supports cursor-based pagination and filtering by status, owner ID, or owner email. Returns an array of lead list summaries (id, name, status, url, shared, visible, owner, type) plus pagination links.

NameTypeRequiredDescription
owner_emailstringoptionalFilter lead lists by the Amplemarket user email of the owner.
owner_idstringoptionalFilter lead lists by the Amplemarket user ID of the owner.
page_afterstringoptionalCursor value to fetch the page of results after this cursor.
page_beforestringoptionalCursor value to fetch the page of results before this cursor.
page_sizestringoptionalNumber of lead lists to return per page.
statusstringoptionalFilter lead lists by status.
amplemarket_mailbox_update#Update a connected sending mailbox's daily email limit. Returns the updated mailbox object including its ID, email, provider, new daily email limit, status, owning user, and timestamps. Returns a 400 error if the requested limit exceeds the account's maximum allowed, or a 404 error if the mailbox ID does not exist.2 params

Update a connected sending mailbox's daily email limit. Returns the updated mailbox object including its ID, email, provider, new daily email limit, status, owning user, and timestamps. Returns a 400 error if the requested limit exceeds the account's maximum allowed, or a 404 error if the mailbox ID does not exist.

NameTypeRequiredDescription
daily_email_limitintegerrequiredThe new daily email sending limit for this mailbox.
idstringrequiredThe ID of the mailbox to update.
amplemarket_mailboxes_list#List the sending mailboxes connected to the Amplemarket workspace, with optional filtering by status, email provider, or user email, and cursor-based pagination. Returns each mailbox's ID, email address, provider, daily email limit, status, and owning user.6 params

List the sending mailboxes connected to the Amplemarket workspace, with optional filtering by status, email provider, or user email, and cursor-based pagination. Returns each mailbox's ID, email address, provider, daily email limit, status, and owning user.

NameTypeRequiredDescription
email_providerstringoptionalFilter mailboxes by their email provider.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page (max 20).
statusstringoptionalFilter mailboxes by their connection status.
user_emailstringoptionalFilter mailboxes by the email address of the owning user.
amplemarket_people_enrichment_cancel#Cancel a pending or in-progress batch people enrichment request in Amplemarket by its ID. This transitions the batch's status to 'canceled' rather than deleting it; the batch and any partial results remain retrievable. Returns a 400 if the batch has already finished, or a 404 if the batch ID does not exist.1 param

Cancel a pending or in-progress batch people enrichment request in Amplemarket by its ID. This transitions the batch's status to 'canceled' rather than deleting it; the batch and any partial results remain retrievable. Returns a 400 if the batch has already finished, or a 404 if the batch ID does not exist.

NameTypeRequiredDescription
idstringrequiredID of the batch people enrichment request to cancel.
amplemarket_people_enrichment_get#Retrieve the status and results of a previously started batch people enrichment request by its batch ID. While the batch is still processing, 'status' will be 'queued' or 'processing' and 'results' may be incomplete; once 'completed', each result includes the matched person object (or a not-found indicator) for the corresponding input lead. Returns a 404 error if the batch ID does not exist.4 params

Retrieve the status and results of a previously started batch people enrichment request by its batch ID. While the batch is still processing, 'status' will be 'queued' or 'processing' and 'results' may be incomplete; once 'completed', each result includes the matched person object (or a not-found indicator) for the corresponding input lead. Returns a 404 error if the batch ID does not exist.

NameTypeRequiredDescription
idstringrequiredThe batch ID of the people enrichment request to retrieve, as returned by amplemarket_people_enrichment_start.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
amplemarket_people_enrichment_start#Start an asynchronous batch enrichment request for a list of people (leads), each identified by email, LinkedIn URL, or name plus company. Optionally reveal email addresses or phone numbers for the whole batch, which consumes Amplemarket credits. Returns a batch request with an ID and a 'queued' status; poll amplemarket_people_enrichment_get with that ID to retrieve results once processing completes.3 params

Start an asynchronous batch enrichment request for a list of people (leads), each identified by email, LinkedIn URL, or name plus company. Optionally reveal email addresses or phone numbers for the whole batch, which consumes Amplemarket credits. Returns a batch request with an ID and a 'queued' status; poll amplemarket_people_enrichment_get with that ID to retrieve results once processing completes.

NameTypeRequiredDescription
leadsarrayrequiredArray of lead objects to enrich. Each lead should include at least one identifier: email, linkedin_url, or name combined with company_name/company_domain. Optional fields per lead: email, linkedin_url, company_domain, company_name, name, title.
reveal_emailbooleanoptionalWhether to reveal email addresses for the enriched people in this batch. Consumes an email credit per person the first time it is revealed.
reveal_phone_numbersbooleanoptionalWhether to reveal phone numbers for the enriched people in this batch. Consumes a phone credit per person the first time it is revealed.
amplemarket_person_find#Synchronously find and enrich a single person in the Amplemarket database by email, LinkedIn URL, or name plus company. At least one identifier (email, linkedin_url, or name combined with company_name/company_domain) must be provided. Optionally reveal the person's email address or phone numbers, which consumes Amplemarket credits. Returns the matched person's profile (name, title, headline, location, LinkedIn URL, company, experiences, educations, languages) or a not-found result if no match exists.8 params

Synchronously find and enrich a single person in the Amplemarket database by email, LinkedIn URL, or name plus company. At least one identifier (email, linkedin_url, or name combined with company_name/company_domain) must be provided. Optionally reveal the person's email address or phone numbers, which consumes Amplemarket credits. Returns the matched person's profile (name, title, headline, location, LinkedIn URL, company, experiences, educations, languages) or a not-found result if no match exists.

NameTypeRequiredDescription
company_domainstringoptionalDomain of the company the person works at, used to narrow down a name-based search.
company_namestringoptionalName of the company the person works at, used to narrow down a name-based search.
emailstringoptionalEmail address to match against a person record.
linkedin_urlstringoptionalLinkedIn profile URL to match against a person record.
namestringoptionalFull name of the person to search for. Should be combined with company_name or company_domain (and optionally title) to disambiguate.
reveal_emailbooleanoptionalWhether to reveal the matched person's email address. Consumes an email credit the first time it is revealed for a person.
reveal_phone_numbersbooleanoptionalWhether to reveal the matched person's phone numbers. Consumes a phone credit the first time it is revealed for a person.
titlestringoptionalJob title of the person, used to narrow down a name-based search.
amplemarket_phone_number_review#Submit a data-quality review for a phone number in Amplemarket, flagging it as incorrect (e.g. wrong number) to help improve data accuracy. Requires the reviewing user's UUID and a reason code.3 params

Submit a data-quality review for a phone number in Amplemarket, flagging it as incorrect (e.g. wrong number) to help improve data accuracy. Requires the reviewing user's UUID and a reason code.

NameTypeRequiredDescription
idstringrequiredThe unique identifier of the phone number record being reviewed.
reasonstringrequiredReason code for the phone number review.
user_idstringrequiredUUID of the Amplemarket user submitting the review.
amplemarket_sequence_add_leads#Add one or more leads to an existing outreach sequence identified by its ID. Each lead is matched/created by email and/or linkedin_url, and can include custom data fields, CRM routing, validation overrides, and sender/mailbox distribution settings. Returns counts of leads added and skipped, plus lists of duplicates or excluded leads.2 params

Add one or more leads to an existing outreach sequence identified by its ID. Each lead is matched/created by email and/or linkedin_url, and can include custom data fields, CRM routing, validation overrides, and sender/mailbox distribution settings. Returns counts of leads added and skipped, plus lists of duplicates or excluded leads.

NameTypeRequiredDescription
leadsarrayrequiredArray of lead objects to add to the sequence. Each lead should include at least an email or linkedin_url. Example: [{"email": "john.doe@example.com"}]
sequence_idstringrequiredThe unique identifier of the sequence to add leads to.
amplemarket_sequences_list#List outreach sequences (email/LinkedIn campaigns) in the Amplemarket account. Supports cursor-based pagination and filtering by status, creator, and name. Returns an array of sequence summaries (id, name, status, priority, url, tags) plus pagination links.7 params

List outreach sequences (email/LinkedIn campaigns) in the Amplemarket account. Supports cursor-based pagination and filtering by status, creator, and name. Returns an array of sequence summaries (id, name, status, priority, url, tags) plus pagination links.

NameTypeRequiredDescription
created_by_user_emailstringoptionalFilter sequences by the Amplemarket user email of the creator.
created_by_user_idstringoptionalFilter sequences by the Amplemarket user ID of the creator.
namestringoptionalSearch sequences by name (case insensitive, partial match).
page_afterstringoptionalCursor value to fetch the page of results after this cursor.
page_beforestringoptionalCursor value to fetch the page of results before this cursor.
page_sizestringoptionalNumber of sequences to return per page.
statusstringoptionalFilter sequences by status.
amplemarket_task_complete#Mark an Amplemarket task as complete by its ID. Optionally, also mark the associated lead/sequence step as completed via set_lead_to_completed.2 params

Mark an Amplemarket task as complete by its ID. Optionally, also mark the associated lead/sequence step as completed via set_lead_to_completed.

NameTypeRequiredDescription
idstringrequiredThe ID of the task to mark as complete.
set_lead_to_completedbooleanoptionalWhether to also mark the associated lead as completed. Defaults to false.
amplemarket_task_skip#Skip an Amplemarket task by its ID. Tasks that are already in a 'completed' status cannot be skipped and will return a 400 error.1 param

Skip an Amplemarket task by its ID. Tasks that are already in a 'completed' status cannot be skipped and will return a 400 error.

NameTypeRequiredDescription
idstringrequiredThe ID of the task to skip.
amplemarket_tasks_list#List tasks assigned to a user in the Amplemarket workspace. Requires a user_id to filter by. Supports additional filters (automation type, task type, status, contact local time window, message opens, keyword search across name/email/company, sequence) and cursor-based pagination. Returns each task's ID, automatic flag, type, status, due date, associated user, and contact.12 params

List tasks assigned to a user in the Amplemarket workspace. Requires a user_id to filter by. Supports additional filters (automation type, task type, status, contact local time window, message opens, keyword search across name/email/company, sequence) and cursor-based pagination. Returns each task's ID, automatic flag, type, status, due date, associated user, and contact.

NameTypeRequiredDescription
user_idstringrequiredID of the user to filter tasks by. Required by the Amplemarket API.
automaticbooleanoptionalFilter by whether the task is automatic (system-generated) or manual.
contact_local_time_fromintegeroptionalMinimum contact local hour (0-23) to filter tasks by.
contact_local_time_tointegeroptionalMaximum contact local hour (0-23) to filter tasks by.
keywordstringoptionalKeyword to search across the task's associated contact name, email, or company.
message_opensintegeroptionalMinimum number of message opens to filter tasks by.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
sequence_keystringoptionalFilter tasks by the key of the sequence they are associated with.
statusstringoptionalFilter tasks by status.
typestringoptionalFilter tasks by type.
amplemarket_tasks_statuses_list#List the available task status values in Amplemarket (e.g. due, upcoming, completed, skipped, paused, cancelled). Useful metadata lookup for filtering or validating task status values used with other task endpoints.0 params

List the available task status values in Amplemarket (e.g. due, upcoming, completed, skipped, paused, cancelled). Useful metadata lookup for filtering or validating task status values used with other task endpoints.

amplemarket_tasks_types_list#List the available task type values in Amplemarket (e.g. email, linkedin_visit, linkedin_connect, phone_call, custom_task, whatsapp, sms). Useful metadata lookup for filtering or validating task type values used with other task endpoints.0 params

List the available task type values in Amplemarket (e.g. email, linkedin_visit, linkedin_connect, phone_call, custom_task, whatsapp, sms). Useful metadata lookup for filtering or validating task type values used with other task endpoints.

amplemarket_users_list#List users in the authenticated Amplemarket workspace, with optional filtering by status, role, or email, and cursor-based pagination. Returns each user's ID, name, email, role, status, and associated mailboxes.6 params

List users in the authenticated Amplemarket workspace, with optional filtering by status, role, or email, and cursor-based pagination. Returns each user's ID, name, email, role, status, and associated mailboxes.

NameTypeRequiredDescription
emailstringoptionalFilter users by email address.
page_afterstringoptionalPagination cursor to fetch results after this point.
page_beforestringoptionalPagination cursor to fetch results before this point.
page_sizestringoptionalNumber of results to return per page.
rolestringoptionalFilter users by their role assignment.
statusstringoptionalFilter users by their status.