# Enrich contacts

Queue contacts for LinkedIn data enrichment. GetSales will visit each contact's
LinkedIn profile and update their data — name, position, company, skills,
education, location, and more.

How it works:
1. Select contacts by filter or specific UUIDs
2. The system validates your team has enough enrichment credits
3. Contacts are added to the enrichment queue
4. A LinkedIn browser visits each profile and updates the data automatically

Credit system: Each contact queued for enrichment costs one credit.
Credits are counted per calendar month. Check your remaining balance
via the POST /leads/api/enrichment-queue/metrics endpoint and your
team's credits.advanced_enrichment limit via GET /id/api/teams/{id}.

You can pass either a filter object (same format as search/mass-action filters)
or an array of specific uuids. At least one matching contact must exist.

Endpoint: PUT /leads/api/leads/advanced-enrichment
Version: 1.0.0
Security: bearerAuth

## Request fields (application/json):

  - `filter` (object)
    Mass action filter. Same format as the /leads/api/leads/mass-action filter. Use all: true with a leadFilter to select contacts by criteria, or all: false with specific ids.

  - `filter.all` (boolean)

  - `filter.ids` (array)

  - `filter.excludeIds` (array)

  - `filter.leadFilter` (object)
    Same filter object as in search — list_uuid, linkedin_status, tags, etc.

  - `uuids` (array)
    Specific contact UUIDs to enrich. Required if filter is not provided.

## Response 200 fields (application/json):

  - `count` (integer)
    Number of contacts added to the enrichment queue

## Response 402 fields (application/json):

  - `error` (object)

  - `error.reason` (string)
    Error category
    Example: "validation_error"

  - `error.message` (string)
    Detailed error message
    Example: "The name field is required."

  - `error.data` (object)
    Additional context (field-level errors for validation)

  - `message` (string)
    Example: "Validation failed"

  - `code` (integer)
    Example: 422