---
title: "Removes a user"
method: DELETE
path: "/settings/users/2026-03/{userId}"
tags: ["Users"]
---

# Removes a user

`DELETE /settings/users/2026-03/{userId}`

Removes a user identified by `userId`. `userId` refers to the user's ID by default, or optionally email as specified by the `IdProperty` query param.

## Path parameters

- `userId` string, required

## Query parameters

- `idProperty` 'EMAIL' | 'USER_ID'

## Response `204`

No content

## Other responses

- `default` — An error occurred.

---

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