---
title: "Search Crm Contact Identity Candidates"
method: POST
path: "/api/crm/identity/contact-candidates"
tags: ["growth-artifact-jobs"]
---

# Search Crm Contact Identity Candidates

`POST /api/crm/identity/contact-candidates`

## Request

- Base URL: `https://platform.verbiflow.com/api/bridge`
- URL: `https://platform.verbiflow.com/api/bridge/api/crm/identity/contact-candidates`
- Auth: one of:
  - HTTP bearer and API key in header `x-flage-org-id`
  - HTTP bearer and API key in header `x-flage-org-slug`

## Request body

- CrmContactCandidateSearchRequest
  - `provider` 'hubspot'
  - `queries` CrmContactCandidateQueryInput[], required
    - `company_domain` string, nullable
    - `company_linkedin_url` string, nullable
    - `company_name` string, nullable
    - `company_provider_id` string, nullable
    - `first_name` string, required
    - `last_name` string, required
    - `source_key` string, required
  - `top_k` integer

## Response `200`

Successful Response

- CrmContactCandidateSearchResponse
  - `active_generation_id` string, required
  - `provider` 'hubspot', required
  - `provider_account_id` string, required
  - `request_count` integer, required
  - `results` CrmContactCandidateResultResponse[], required
    - `candidates` CrmContactCandidateMatchResponse[], required
      - `associated_company_ids` string[], required
      - `company_match_basis` string, required
      - `company_similarity` number, nullable, required
      - `first_name_similarity` number, required
      - `last_name_similarity` number, required
      - `name_similarity` number, required
      - `properties` object, required
      - `provider_record_id` string, required
      - `review_recommended` boolean, required
    - `request_index` integer, required
    - `source_key` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)