---
title: "POST /lead_finder/async"
method: POST
path: "/lead_finder/async"
---

# POST /lead_finder/async

`POST /lead_finder/async`

Create a new lead finder request to find people working in specific companies

## Request body

- LeadFinderRequest
  - `filters` LeadFinderFilters, required
    - `company` CompanyDomainFilter
      - `include` string[], nullable — Company domains that must match (e.g. 'google.com', 'microsoft.com')
      - `exclude` string[], nullable — Company domains that must NOT match (e.g. 'google.com', 'microsoft.com')
    - `company_industry` CompanyIndustryFilter
      - `include` string[], nullable — Company industries that must match. Must be exact values from the predefined list.
      - `exclude` string[], nullable — Company industries that must NOT match. Must be exact values from the predefined list.
    - `company_technology` FilterObject
      - `include` string[], nullable — Values that must match
      - `exclude` string[], nullable — Values that must NOT match
    - `company_headcount_min` integer — Minimum employee count
    - `company_headcount_max` integer — Maximum employee count
    - `lead_fullname` FilterObject
      - `include` string[], nullable — Values that must match
      - `exclude` string[], nullable — Values that must NOT match
    - `lead_linkedin_url` FilterObject
      - `include` string[], nullable — Values that must match
      - `exclude` string[], nullable — Values that must NOT match
    - `lead_department` LeadDepartmentFilter
      - `include` string[], nullable — Lead departments that must match. Must be exact values from the predefined list.
      - `exclude` string[], nullable — Lead departments that must NOT match. Must be exact values from the predefined list.
    - `lead_function` LeadFunctionFilter
      - `include` string[], nullable — Lead functions that must match. Must be exact values from the predefined list.
      - `exclude` string[], nullable — Lead functions that must NOT match. Must be exact values from the predefined list.
    - `lead_skills` FilterObject
      - `include` string[], nullable — Values that must match
      - `exclude` string[], nullable — Values that must NOT match
    - `lead_job_title` JobTitleFilter
      - `include` string[], nullable — Values that must match
      - `exclude` string[], nullable — Values that must NOT match
      - `exact_match` boolean — When enabled, only exact job title matches are returned
    - `lead_location` FilterObject
      - `include` string[], nullable — Values that must match
      - `exclude` string[], nullable — Values that must NOT match
    - `lead_seniority` SeniorityFilter
      - `include` string[], nullable — Seniority levels that must match. Possible values: senior, entry, manager, mid-level, director, c_suite, owner, intern, founder, head, vp, partner
      - `exclude` string[], nullable — Seniority levels that must NOT match. Possible values: senior, entry, manager, mid-level, director, c_suite, owner, intern, founder, head, vp, partner
  - `limit` integer — Maximum number of results to return per request. Accepted values between 1 and 200. By default, up to 100 leads are returned
  - `offset` integer — Number of results to skip before returning matches. Use this to paginate through results when the total number of leads found (visible in the `leads_found` attribute of the response) exceeds the `limit` of the current request. For example, if `leads_found` is 350 and `limit` is 100, set `offset` to 101 to retrieve the next page of results.
  - `webhook` string, nullable — Optional URL to receive results automatically

## Response `201`

Lead finder request accepted

- object
  - `success` boolean
  - `message` string
  - `request_id` string

## Other responses

- `401` — Not authorized

---

[API](https://skmtc.dev/bettercontact/apis/bettercontact-api.md) · [All operations](https://skmtc.dev/bettercontact/apis/bettercontact-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bettercontact/bettercontact-api/revisions/c2d10d6670df/schema)