---
title: "Remove user"
method: POST
path: "/user/remove"
tags: ["plaid"]
---

# Remove user

`POST /user/remove`

`/user/remove` deletes a user token and and associated information, including any Items associated with the token.
Any subsequent calls to retrieve information using the same user token will result in an error stating the user does not exist.
If a user is created for a given `client_user_id` using `/user/create` and that user is then deleted with `/user/remove`, the `client_user_id` cannot be reused for another `/user/create` request.

## Headers

- `Plaid-New-User-API-Enabled` boolean

## Request body

- UserRemoveRequest — UserRemoveRequest defines the request schema for `/user/remove`
  - `client_id` string — Your Plaid API `client_id`. The `client_id` is required and may be provided either in the `PLAID-CLIENT-ID` header or as part of a request body.
  - `secret` string — Your Plaid API `secret`. The `secret` is required and may be provided either in the `PLAID-SECRET` header or as part of a request body.
  - `user_token` string — The user token associated with the User data is being requested for.
  - `user_id` string — A unique `user_id` generated by Plaid for the client-provided `client_user_id`. This field is currently in beta.

## Response `200`

OK

- UserRemoveResponse — UserRemoveResponse defines the response schema for `/user/remove`
  - `request_id` string, required — A unique identifier for the request, which can be used for troubleshooting. This identifier, like all Plaid identifiers, is case sensitive.

## Changes

- **2025-06-03** `b7200537f765` — 2 breaking
  - for the `header` request parameter `Plaid-New-User-API-Enabled`, default value `false` was added
  - for the `header` request parameter `Plaid-New-User-API-Enabled`, the type/format was changed from `string`/`` to `boolean`/``
- **2025-05-19** `02e6d58e95e9` — 3 info
  - added the new optional `header` request parameter `Plaid-New-User-API-Enabled`
  - added the new optional request property `user_id`
  - the request property `user_token` became optional
- **2024-07-05** `1e30969bd889` — 1 info
  - endpoint added
- **2024-02-21** `5de70cc1e6ca` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/plaid/apis/the-plaid-api/changes/user/remove/post.md)

---

[API](https://skmtc.dev/plaid/apis/the-plaid-api.md) · [All operations](https://skmtc.dev/plaid/apis/the-plaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/plaid/the-plaid-api/revisions/af4b6e71d87f/schema)