---
title: "Delete contacts in bulk"
method: DELETE
path: "/contacts/{companyId}"
tags: ["Contacts"]
---

# Delete contacts in bulk

`DELETE /contacts/{companyId}`

Deletes several contacts in a single call, identified by `customId`. Entries whose `customId` does not match any contact are silently skipped — no error is raised and the call still returns `200` for the whole batch.

## Path parameters

- `companyId` string, required

## Request body

- BulkDeleteContactsRequestSchema
  - `data` DeleteContactsRequestSchema[], required — Contacts to delete, identified by `customId`.
    - `customId` string, required — Custom ID of the contact to delete.

## Response `200`

Successful Response

- BulkModifyContactsResponseSchema
  - `data` ModifyContactsResponseSchema[], required — Result of the bulk operation, one entry per contact.
    - `id` string, required — Embat resource ID

## Other responses

- `401` — Unauthorized. The bearer token is missing, invalid or expired.
- `404` — Not found. The requested resource or `companyId` does not exist.
- `422` — Validation Error
- `500` — Unexpected error. Contact support if it persists.

---

[API](https://skmtc.net/embat/apis/embat-api.md) · [All operations](https://skmtc.net/embat/apis/embat-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/embat/embat-api/revisions/36ca48bf4489/schema)