Skip to main content
ContactOut logo
  • Category: people & contact data
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 25
  • Triggers: 0
  • Slug: CONTACTOUT
  • Version: 20261101_00
  • Instant: Supported on the latest version. Support varies by tool.

Tools

Slug: CONTACTOUT_ADD_CAMPAIGN_RECIPIENTSAdd 1-100 recipients to an existing campaign. This consequential write immediately changes the campaign’s recipient set and may lead to outreach when the campaign is active. A successful request can still contain failed recipients, so inspect every result and both counts. Production Campaigns entitlement and mutation behavior are not live-verified.

Input Parameters

array
required
One to 100 recipients to add. Every item requires a valid email or phone number.
string
required
Existing campaign to modify. Adding recipients changes campaign state and may cause outreach if the campaign is active; never use a sample ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_CHECK_LINKEDIN_CONTACT_AVAILABILITYCheck whether a LinkedIn profile has a personal email, work email, or phone without revealing it; free. Managed calls support work email and phone checks only, and production access requires a paid ContactOut entitlement.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
required
LinkedIn profile URL to check without revealing contact data.
string ("personal_email" | "work_email" | "phone")
required
Contact-data type whose availability to check.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_COUNT_PEOPLECount matching people and estimate available work emails and phones using People Search filters; personal-email estimates are also available on non-managed calls. The endpoint consumes no credits and requires a paid ContactOut production entitlement.Instant: Supported on the latest version.Instant pricing: $0 per request

Input Parameters

string
Person name to match.
array
Employer domains to include.
array
Skill expressions to match. Boolean operators AND, OR, and NOT must be uppercase.
array
Company names to include.
string
General profile keyword expression. Boolean operators AND, OR, and NOT must be uppercase.
array
Industries to include; prefix a value with NOT to exclude it. AND and OR are not supported.
array
Person locations to include.
array
Education expressions to match. Boolean operators AND, OR, and NOT must be uppercase.
array
Current job-title expressions to match. Boolean operators AND, OR, and NOT must be uppercase.
array
Languages and optional proficiency levels to match.
array
Seniority levels to include, such as Manager or Vice President.
array
Structured education filters; each entry must set a school name, field of study, or location.
array
Company-size bands to include.
array
Job functions to include, such as Engineering, Marketing, or Sales.
array
Past company names to include. Cannot be combined with company_filter set to past, past_only, or both.
string ("current" | "past" | "past_only" | "both")
Employment periods where company filters apply; omit for the provider default. Cannot be combined with match_experience.
array
Past job-title expressions to match. Boolean operators must be uppercase; incompatible with current_titles_only=false.
integer
Radius in miles around a city or area supplied in location.
string ("current" | "past" | "both")
Require job_title and company to match current, past, or either experience entry.
array
Company names to exclude.
array
Job titles to exclude.
array
Past work locations to include.
boolean
Restrict job-title matching to current roles. Do not set false with past_job_title.
array
Total-experience ranges to include.
boolean
Restrict company matching to current employers.
boolean
Filter for people with an active current role (true) or without one (false); omit to include both.
array
Current work locations to include.
boolean
Restrict results to people whose current job began within the last three calendar months; cannot be combined with years_in_current_role.
array
Current-role tenure ranges to include; cannot be combined with recently_changed_jobs=true.
string ("current" | "past" | "both")
Employment periods where excluded companies apply; independent of company_filter.
Include semantically related job titles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_CREATE_BULK_EMAIL_VERIFICATION_JOBQueue asynchronous deliverability verification for 1-100 email addresses, optionally delivering results to an HTTP or HTTPS callback URL; charged per verified address.

Input Parameters

array
required
Email addresses to verify asynchronously (1-100 addresses).
string
HTTP or HTTPS endpoint that ContactOut should POST completed results to; omit it when results will be polled instead.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_CREATE_LINKEDIN_CONTACT_INFO_BATCH_JOBQueue asynchronous contact discovery for 1-1000 LinkedIn profiles, optionally delivering results to a callback URL; may be charged per profile.

Input Parameters

array
required
LinkedIn profile URLs to process asynchronously (1-1000 URLs).
string ("personal" | "work" | "personal,work" | "none")
Email types to discover; omit to use the provider default.
string
HTTP or HTTPS endpoint that ContactOut should POST completed results to.
boolean
Also discover phone numbers when available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_ENRICH_COMPANIES_BY_DOMAINReturn company profiles for 1–30 domains, charged per company found. Managed calls accept at most 10 distinct domains.Instant: Supported on the latest version.Instant pricing: Est. $0.02 per record returned.

Input Parameters

array
required
Company domains to enrich (1-30).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_ENRICH_LINKEDIN_PROFILEReturn a professional profile for a regular LinkedIn profile URL, optionally including contact data; requesting contact data increases the price.Instant: Supported on the latest version.Instant pricing: Est. $0.02 per profile; +$0.143 per email or phone found ($0.286 both).

Input Parameters

string
required
Regular LinkedIn /in/ or /pub/ profile URL. Sales Navigator and Recruiter URLs are not accepted.
boolean
Return profile details without revealing contact information. Managed calls default to profile-only; explicitly set false to reveal contacts.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_ENRICH_PERSONFind and enrich one person using a LinkedIn URL, email, or phone; alternatively, provide a name plus employer, education, location, or job-title evidence. Charged per match; including work_email or phone increases the price.Instant: Supported on the latest version.Instant pricing: Est. $0.02 per profile; +$0.143 per email or phone found ($0.306 both).

Input Parameters

string
Email address identifying the person. Provide this, linkedin_url, or phone; otherwise provide a name plus secondary evidence.
string
Phone number identifying the person. Provide this, linkedin_url, or email; otherwise provide a name plus secondary evidence.
array
Employer names used as secondary evidence with a name; they cannot identify a person alone.
array
Contact-data types to reveal in addition to profile data. Managed calls accept work_email and phone; omit for profile data only.
string
Location used as secondary evidence with a name; it cannot identify a person alone.
array
Schools or education terms used as secondary evidence with a name; they cannot identify a person alone.
string
Person’s full name. Without linkedin_url, email, or phone, a name requires company, company_domain, education, location, or job_title evidence.
string
Job title used as secondary evidence with a name; it cannot identify a person alone.
string
Last name; provide together with first_name and, without a direct identifier, at least one secondary evidence field.
string
First name; provide together with last_name and, without a direct identifier, at least one secondary evidence field.
string
LinkedIn profile URL identifying the person. Provide this, email, or phone; otherwise provide a name plus secondary evidence.
array
Employer domains used as secondary evidence with a name; they cannot identify a person alone.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_ENRICH_PERSON_BY_EMAILReturn a professional profile matched from an email address, optionally requesting real-time work-email verification. Email and phone credits are consumed when the corresponding contact data is found.

Input Parameters

string
required
Email address used to identify the person.
string
Set to work_email to request real-time work-email verification, which may increase latency.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_FIND_LINKEDIN_PROFILE_BY_EMAILResolve an email address to a matching LinkedIn profile URL; a successful match is charged. Managed calls reject addresses recognized as personal email.Instant: Supported on the latest version.Instant pricing: Estimated $0.143 per found LinkedIn match.

Input Parameters

string
required
Email address to resolve to a matching LinkedIn profile URL.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_GET_API_USAGE_STATSReturn ContactOut API credit usage and quotas for a billing month. Remaining and over-quota fields are available for postpaid accounts, while prepaid accounts report remaining balances in quota fields. ContactOut sandbox responses contain fixed illustrative samples; never present those values as the connected account’s real balances.

Input Parameters

string
Billing month in YYYY-MM or YYYY-MM-DD format. Date inputs are normalized to their month; omit for the current month.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_GET_BULK_EMAIL_VERIFICATION_JOBGet the status and available per-email results of an asynchronous bulk email-verification job.

Input Parameters

string
required
Job ID returned by Create Bulk Email Verification Job.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_GET_CAMPAIGNReturn one campaign’s sequence steps and optionally its performance statistics. Production Campaigns entitlement depends on the connected ContactOut account.

Input Parameters

string
required
Campaign ID returned by List Campaigns.
boolean
Include sends, opens, replies, bounces, and performance rates when available.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_GET_HASHED_EMAIL_IDENTIFIERSReturn unordered SHA-256 hashes of normalized personal emails found for 5-100 distinct LinkedIn profiles. Hashes are not mapped back to profiles and are charged per profile with an email found.

Input Parameters

array
required
Five to 100 distinct LinkedIn profile URLs whose personal email identifiers should be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_GET_LINKEDIN_CONTACT_INFOReveal email and optionally phone contact information for one regular LinkedIn profile URL; charged only when contact data is found. Managed calls reveal work email only, with optional phone.Instant: Supported on the latest version.Instant pricing: $0.15 per work-email hit; est. $0.143 email or phone, $0.286 both, $0 if none.Discount: 5

Input Parameters

string
required
Regular LinkedIn /in/ or /pub/ profile URL.
string ("personal" | "work" | "personal,work" | "none")
Email types to reveal. Omit for personal and work emails; use work for real-time work-email verification. Composio-managed calls default to work; use none with include_phone=true for phone-only lookup.
boolean
Also reveal a phone number when available, which increases the price. Managed calls support phone reveals, billed per profile with a phone hit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_GET_LINKEDIN_CONTACT_INFO_BATCHSynchronously reveal contact information for 1–100 LinkedIn profiles; charges may apply per profile with contact data found. Managed calls accept at most 10 distinct profiles and reveal work emails with optional phone numbers.Instant: Supported on the latest version.Instant pricing: $0.15 per work-email hit. Est. $0.143 per email or phone hit, $0.286 for both.Discount: 5

Input Parameters

array
required
LinkedIn profile URLs to process synchronously (1-100 URLs). Composio-managed calls accept at most 10.
string ("personal" | "work" | "personal,work")
Email types to reveal; omit to use the provider default. Composio-managed calls always use work and reject other values.
boolean
Also reveal phone numbers when available. Managed calls support phone reveals, billed per profile with a phone hit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_GET_LINKEDIN_CONTACT_INFO_BATCH_JOBGet the status and available results of an asynchronous LinkedIn contact-info batch job.

Input Parameters

string
required
Job ID returned by Create LinkedIn Contact Info Batch Job.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_LIST_CAMPAIGNSReturn one page of email campaigns and their lifecycle statuses. Production Campaigns entitlement is unverified; the connected API token may require additional ContactOut plan access.

Input Parameters

integer
Maximum campaigns to return on this page (1-50).
string
Continuation token returned by a previous call. Omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_LIST_DECISION_MAKERSReturn one page of key decision makers for the best-matching company. For the first page, provide a company LinkedIn URL, domain, or name. Charged per returned profile; reveal_info increases the price when contact data is returned.Instant: Supported on the latest version.Instant pricing: Est. $0.02 per profile; +$0.143 per email or phone found ($0.306 both).

Input Parameters

string
Company name to match. For the first page, provide this, linkedin_url, or domain.
string
Company domain to match. For the first page, provide this, linkedin_url, or name.
string
Opaque continuation token from the previous response. It retains the company selectors and reveal_info value.
boolean
Reveal available contact data, which increases the price. Set true to reveal contacts; email and phone hits are billed separately.
string
Company LinkedIn URL, vanity name, or numeric identifier. For the first page, provide this, domain, or name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_REMOVE_CAMPAIGN_RECIPIENTSDestructively remove 1-100 recipients from an existing campaign by email. The request can partially succeed, so inspect every result and both counts. Production Campaigns entitlement and this mutation remain unverified without an isolated campaign fixture.

Input Parameters

array
required
Recipients to remove by email (1-100 recipients).
string
required
Target campaign ID. This operation removes recipients from that campaign; never use a sandbox sample campaign ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_SEARCH_COMPANIESReturn one page of companies matching identity, size, location, industry, technology, revenue, or founding-year filters. Each returned company is charged.Instant: Supported on the latest version.Instant pricing: Est. $0.02 per record returned.

Input Parameters

array
Company names to match.
array
Company-size ranges to include, such as 1_10 or 11_50.
array
Company domains to match.
boolean
Restrict location matching to company headquarters.
array
Industries to include.
array
Company locations to include.
integer ("1000000" | "5000000" | "10000000" | "50000000" | "100000000" | "250000000" | "500000000" | "1000000000")
Maximum company revenue.
integer ("1000000" | "5000000" | "10000000" | "50000000" | "100000000" | "250000000" | "500000000" | "1000000000")
Minimum company revenue.
string
Opaque continuation token returned by the previous page. The token retains the original filters.
array
Company LinkedIn URLs or identifiers. Cannot be combined with any other filter.
array
Technology expressions to match. Uppercase AND, OR, and NOT operators are supported.
integer
Latest founding year, no later than the current year. Requires year_founded_from.
integer
Earliest founding year, from 1985 through the current year.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_SEARCH_PEOPLEReturn one page of professional profiles matching person, role, employer, education, location, and contact-availability filters; returned profiles are charged per profile, with extra charges for revealed contact data found. Managed calls exclude personal-email filters and personal contact data.Instant: Supported on the latest version.Instant pricing: Est. $0.02 per profile; +$0.143 per email or phone found ($0.306 both).

Input Parameters

string
Person name to match.
array
Employer domains to include.
array
Skill expressions. Uppercase AND, OR, and NOT operators are supported.
array
Company names to include.
string
General profile keyword expression. Uppercase AND, OR, and NOT operators are supported.
array
Industries to include; prefix a value with NOT to exclude it. AND and OR are not supported here.
array
Person locations to include.
array
Education expressions. Uppercase AND, OR, and NOT operators are supported.
array
Current job-title expressions. Uppercase AND, OR, and NOT operators are supported.
array
Languages and optional proficiency levels to match.
integer
Maximum profiles to return on this page (1-25).
array
Seniority levels to include.
array
Require availability of at least one of these contact-data types.
array
Structured education filters; every entry must set at least one field.
string
Opaque continuation token returned by the previous page. The token retains the original filters.
boolean
Reveal available contact data, which increases the price. Set true to reveal contacts; email and phone hits are billed separately.
array
Company-size ranges, such as 1_10, 11_50, 51_200, or 10001.
array
Job functions to include.
array
Past company names to include.
array
Profile fields to include in each result.
string ("current" | "past" | "past_only" | "both")
Employment periods where company filters apply. ContactOut defaults to current; omit when using match_experience.
array
Past job-title expressions. Uppercase AND, OR, and NOT operators are supported.
integer
Radius in miles around a city or area supplied in location.
string ("current" | "past" | "both")
Require job-title and company filters to match the same current, past, or either experience. Omit current_titles_only and company_filter when set; ContactOut defaults to current.
array
Company names to exclude.
boolean
Return structured education entries instead of compact strings.
array
Job titles to exclude.
array
Past work locations to include.
boolean
Restrict job-title matching to current roles. ContactOut defaults this to true; omit when using match_experience.
boolean
Return structured experience entries instead of compact strings.
array
Total-experience ranges, such as 1_2, 3_5, 6_10, or 10.
boolean
Restrict company matching to current employers.
boolean
Filter by whether the person has an active current role.
array
Current work locations to include.
boolean
Restrict results to people whose current job began within the last three calendar months.
array
Current-role tenure ranges, such as 1_2 or 3_5; cannot be combined with recently_changed_jobs=true.
string ("current" | "past" | "both")
Employment periods where excluded companies apply.
Include semantically related job titles.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_START_CAMPAIGNStart a draft ContactOut campaign or resume a stopped campaign. This can immediately begin sending real outreach to the campaign’s recipients and is an irreversible external side effect; confirm the campaign ID and intent before calling. Calling it for an already-active campaign is an idempotent success. Production Campaigns entitlement depends on the connected account.

Input Parameters

string
required
Draft or stopped campaign to start. Starting it can immediately send real outreach to its recipients; never use a sandbox sample campaign ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_STOP_CAMPAIGNStop a running ContactOut campaign, interrupting its outreach. This is a consequential lifecycle change; use only with an explicitly selected active campaign. Repeating the request for an already-stopped campaign is treated as an idempotent success when ContactOut returns success.

Input Parameters

string
required
Active campaign ID to stop. This interrupts outreach from the campaign; never use a sandbox sample ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: CONTACTOUT_VERIFY_EMAILCheck one email address for valid, invalid, accept-all, disposable, or unknown deliverability. A valid, invalid, or accept-all result is charged.

Input Parameters

string
required
Email address whose deliverability should be verified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not