---
title: "Disconnect an account"
method: POST
path: "/accounts/{account_id}/disconnect"
tags: ["Accounts"]
---

# Disconnect an account

`POST /accounts/{account_id}/disconnect`

## Request

- Base URL: `https://api.getpinwheel.com/v1`
- URL: `https://api.getpinwheel.com/v1/accounts/{account_id}/disconnect`
- Auth: API key in header `X-API-SECRET`
- TypeScript: <https://skmtc.dev/getpinwheel/apis/pinwheel/docs/accounts/:account_id/disconnect/post.ts> (a function with typed inputs; its response is checked against the schema)

Disconnect an account. This is permanent and irreversible. Once complete, an account will no longer support Earnings Streams or Recurring Access, e.g., On Demand Updates will no longer work and Monitoring will no longer be performed. However, old data will remain accessible. As mentioned above, this excludes derived data products e.g. Earnings Stream.

## Path parameters

- `account_id` string, uuid, required: UUID of the payroll account.

## Headers

- `Pinwheel-Version` '2025-07-08' | '2023-11-22' | '2023-07-18' | '2023-04-18' | '2022-09-09' | '2022-06-22' | '2022-03-02', required

## Response `204`

No Content

---

[API](https://skmtc.dev/getpinwheel/apis/pinwheel.md) - [All operations](https://skmtc.dev/getpinwheel/apis/pinwheel/llms.txt) - [OpenAPI document](https://skmtc.dev/getpinwheel/apis/pinwheel/revisions/d1c86ae1189c?raw)