---
title: "Delete email-only users in bulk"
method: DELETE
path: "/api/v1/users/email-only/bulk"
tags: ["Users"]
---

# Delete email-only users in bulk

`DELETE /api/v1/users/email-only/bulk`

Deletes up to 100 email-only users, named by ID, by email, or a mix of both, and removes them from every schedule they receive. Only email-only users are deleted: an identifier that belongs to any other kind of user, or to no user, is returned under `notFound` and the rest of the request still succeeds.

## Request body

- union
  - object
    - `emails` string[], required — Email addresses of the email-only users to delete
    - `userIds` string[] — IDs of the email-only users to delete, as returned by the list and create endpoints
  - object
    - `emails` string[] — Email addresses of the email-only users to delete
    - `userIds` string[], required — IDs of the email-only users to delete, as returned by the list and create endpoints

## Response `200`

The deleted users and any identifiers that matched no email-only user

- ApiUsersEmailOnlyUsersBulkDeleteResponse
  - `deleted` ApiEmailOnlyUserResponse[], required — The email-only users that were deleted
    - `email` string, email, required — Email address of the user
    - `userId` string, required — ID of the user
  - `notFound` object, required — Requested identifiers that matched no email-only user in the organization
    - `emails` string[], required — Requested emails that do not belong to an email-only user
    - `userIds` string[], required — Requested IDs that do not belong to an email-only user

## Other responses

- `400` — Invalid request - must provide 1-100 valid emails and user IDs in total
- `401` — Authentication required
- `403` — Permission denied - user-scoped API keys require permission to add and remove users

## Changes

- **2026-09-22** `d3c0855161b1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/omniapp/apis/omni-api/changes/api/v1/users/email-only/bulk/delete.md)

---

[API](https://skmtc.dev/omniapp/apis/omni-api.md) · [All operations](https://skmtc.dev/omniapp/apis/omni-api/llms.txt) · [OpenAPI document](https://skmtc.dev/omniapp/apis/omni-api/revisions/299eacbcab4d?raw)