Account Mapping

Account Mapping resolves a company by domain or LinkedIn identifier, then asynchronously enriches the company mapping for the target partner workspace.

Use Account Mapping when you need to discover and retrieve people attached to a target account, including profile data such as name, position, LinkedIn URL, email, phone number, and location when available.

All endpoints authenticate with your partner master key and follow the shared error model — see the Provider API overview.

Workflow

1. Enrich company mapping starts an asynchronous enrichment job and returns 202 Accepted.
2. List company mappings returns paginated materialized mappings without profiles.
3. Get company mapping returns one mapping with all enriched employee profiles.

Endpoints

• List company mappings: paginated list of materialized mappings without profiles.
• Get company mapping: one mapping with enriched employee profiles.
• Enrich company mapping: asynchronous company resolution and enrichment.

Polling enrichment stage

After calling Enrich company mapping, poll Get a content request to track progress, using the request_id returned by the enrich response as the {id} path parameter:

Response shape

{
  "id": 12345,
  "type": "account_mapping",
  "stage": "account_mapping_in_progress",
  "created_at": "2026-06-12T08:30:00.000Z",
  "updated_at": "2026-06-12T08:31:00.000Z",
  "company": {
    "id": 8421,
    "name": "Acme",
    "domain": "acme.com",
    "linkedin_url": "https://www.linkedin.com/company/acme"
  },
  "inputs": {}
}

Terminal stages: completed (enrichment succeeded) and account_mapping_failed (enrichment failed). Stop polling when either is reached. See Get a content request for the full field reference and stage list.

Pagination

List endpoints use page-based pagination.

Paginated responses include meta.pagination:

{
  "meta": {
    "pagination": {
      "page": 1,
      "page_size": 25,
      "page_count": 1,
      "total": 12
    }
  }
}