---
title: "Bulk Contacts"
method: POST
path: "/api/companies/{company_uuid}/contacts/bulk"
tags: ["company-contacts"]
---

# Bulk Contacts

`POST /api/companies/{company_uuid}/contacts/bulk`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/contacts/bulk`
- Auth: HTTP bearer

## Path parameters

- `company_uuid` string, uuid, required

## Headers

- `X-User-Email` string, nullable
- `X-User-Name` string, nullable

## Request body

- CompanyContactBulkRequest: Request schema for bulk contact operations.
  - `action` 'delete' | 'select' | 'deselect' | 'add_owner' | 'add_collections' | 'remove_collections' | 'remove_owner' | 'restore', required: Supported bulk actions for contacts.
  - `selected` boolean, nullable: Current list filter by selection status
  - `search` string, nullable: Current list search term
  - `search_name` string, nullable: Current list name-only search term
  - `user_uuid` string, uuid4, nullable: Current list owner filter
  - `organization_uuid` string[], nullable: Current list organization UUID filters
  - `organization_type` TypeEnum[], nullable: Current list organization type filters
  - `country_id` integer[], nullable: Current list country ID filters
  - `position` string, nullable: Current list position filter
  - `department` string, nullable: Current list department filter
  - `regdoor_verified` boolean, nullable: Current list RegDoor verified filter
  - `collection_list` string[], nullable: Current list collection name filters
  - `sort_by` string, nullable: Current list sort field
  - `sort_order` string, nullable: Current list sort order
  - `include_contact_uuids` string[], nullable: Manual contact UUID selection. When present, filters are ignored.
  - `exclude_contact_uuids` string[], nullable: Contact UUIDs excluded from a filtered bulk selection
  - `assign_owner_user_uuid` string, uuid4, nullable: User UUID to assign as owner for add_owner bulk action
  - `collections_to_add` string[], nullable: Collection names to merge for add_collections bulk action
  - `collections_to_remove` string[], nullable: Collection names to remove for remove_collections bulk action

## Response `200`

Successful Response

- CompanyContactBulkResponse: Response schema for bulk contact preview and execution.
  - `action` 'delete' | 'select' | 'deselect' | 'add_owner' | 'add_collections' | 'remove_collections' | 'remove_owner' | 'restore', required: Supported bulk actions for contacts.
  - `eligible_count` integer, required
  - `blocked_count` integer, required
  - `processed_count` integer, nullable
  - `processed_uuids` string[]: UUIDs of contacts effectively processed by execute
  - `blocked_examples` CompanyContactBulkBlockedExample[]
    - `contact_uuid` string, uuid4, nullable
    - `name` string, nullable
    - `reason` string, required
  - `blocked_reasons` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)