---
title: "Create bulk email enrichment job"
method: POST
path: "/people/email/bulk"
tags: ["People / Enrichment"]
---

# Create bulk email enrichment job

`POST /people/email/bulk`

## Request

- Base URL: `https://api.companyenrich.com`
- URL: `https://api.companyenrich.com/people/email/bulk`
- Auth: API key in header `Authorization`

**Cost:** up to 10 credits per item (charged on completion for newly accessed found emails only)

Creates an asynchronous bulk person email enrichment job for up to 1,000 lookup items.
When `domain` is omitted for an item, current experience domains are tried in seniority order.
Processing happens asynchronously in the background. Use the status endpoint to monitor progress and retrieve the results download URL.

## Request body

- BulkPersonEmailEnrichmentRequest
  - `items` BulkPersonEmailEnrichmentItemRequest[], required: A list of person email enrichment lookups. Up to 1,000 items can be provided.
    - `person_id` integer, required: The CompanyEnrich person ID to enrich.
    - `domain` string, nullable: Optional company domain to resolve the email address on. If omitted, current experience domains are tried in seniority order.
  - `webhook_url` string, uri, nullable: The webhook URL to receive the notification when processing completes.

## Response `200`

OK

- BulkPersonEmailEnrichmentResponse
  - `job_id` string, uuid: Unique identifier for the bulk person email enrichment job.
  - `status` 'pending' | 'processing' | 'completing' | 'completed' | 'failed': Current status of the job (pending, processing, completing, completed, failed).
  - `total_requests` integer: Number of lookup items queued in the job.
  - `estimated_credits` integer: Estimated maximum credit cost for the job.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `422`: Unprocessable Entity
- `429`: Too Many Requests

---

[API](https://skmtc.dev/companyenrich/apis/company-enrich-api.md) - [All operations](https://skmtc.dev/companyenrich/apis/company-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/companyenrich/apis/company-enrich-api/revisions/07f84debab87?raw)