---
title: "Create a new bulk search by sending a CSV file in the request body."
method: POST
path: "/v5.1/bulk/json"
tags: ["bulk"]
---

# Create a new bulk search by sending a CSV file in the request body.

`POST /v5.1/bulk/json`

## Request

- Base URL: `https://api.anymailfinder.com`
- URL: `https://api.anymailfinder.com/v5.1/bulk/json`
- Auth: API key in header `Authorization`

## Headers

- `x-webhook-url` string

## Request body

- Api51BulkCreateWithJsonBodyDto
  - `company_name_field_index` number: The zero-based index of the column containing the company name in the uploaded file.
  - `data` array[], required
    - object[]: A multidimensional array containing rows and columns. The first row is expected to contain headers unless has_header is set to false.
  - `decision_maker_category` string[]: One or more categories of the decision maker(s) to search for. If multiple are provided, they are treated in order of importance and the result will use the first category that resolves to a valid email. One or more of the following: "ceo", "engineering", "finance", "hr", "it", "logistics", "marketing", "operations", "buyer", "sales".
  - `domain_field_index` number: The zero-based index of the column containing the company website (domain) in the uploaded file.
  - `email_field_index` number: The zero-based index of the column containing the emails to validate in the uploaded file.
  - `file_name` string: A label to identify the bulk search.
  - `first_name_field_index` number: The zero-based index of the column containing the first name in the uploaded file.
  - `full_name_field_index` number: The zero-based index of the column containing the full name in the uploaded file.
  - `has_header` boolean: Whether the first row of the data array contains headers. Defaults to true. Set to false if the first row is data.
  - `last_name_field_index` number: The zero-based index of the column containing the last name in the uploaded file.
  - `linkedin_url_field_index` number: The zero-based index of the column containing the Linkedin URL in the uploaded file.
  - `webhook_url` string: URL where we should send a webhook when the file processing has completed.

## Response `200`

Created.

- Api5SearchBulkDto
  - `status` 'on_deck' | 'queued' | 'running' | 'paused' | 'completed' | 'deleted' | 'extraction_queued' | 'extraction_running', required: The current status of the bulk operation. Each status represents a specific stage in the bulk operation lifecycle:<br /> - "on_deck": Indicates the bulk file has been uploaded through the UI, but the columns have not been mapped yet. This status is internal and typically not encountered by API users.<br /> - "queued": The bulk operation is queued and will be processed soon. This status implies that the operation is in the waiting list and will be picked up by the processing system.<br /> - "running": The bulk operation is currently in progress. This status indicates that the processing of the bulk file is actively ongoing.<br /> - "paused": The operation has been temporarily paused.<br /> - "completed": The bulk operation has been completed successfully. All records in the bulk file have been processed as intended.<br /> - "failed": The bulk operation has failed. This status indicates that there was an error during the processing which prevented the operation from completing successfully.<br /> Note: The status flow typically progresses from "queued" to "running", and then to either "completed" or "failed", but can also include "paused".
  - `counts` object, required
    - `failed` number, required
    - `found_unknown` number, required
    - `found_valid` number, required
    - `not_found` number, required
    - `total` number, required
  - `created_at` string, date-time, required
  - `credits_needed` number, required
  - `decision_maker_category` string, nullable, required
  - `file_name` string, required
  - `id` string, required
  - `paid` boolean, required
  - `started_running_at` string, date-time, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/anymailfinder/apis/anymail-finder-api.md) · [All operations](https://skmtc.dev/anymailfinder/apis/anymail-finder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anymailfinder/apis/anymail-finder-api/revisions/cd6d62ec7603?raw)