---
title: "Suspend a company's account"
method: POST
path: "/v1/companies/{company_uuid}/suspensions"
tags: ["Companies"]
---

# Suspend a company's account

`POST /v1/companies/{company_uuid}/suspensions`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/suspensions`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_uuid/suspensions/post.ts> (a function with typed inputs; its response is checked against the schema)

Use this endpoint to suspend a company. After suspension, company will no longer be able to run payroll but will retain access to their information, such as retrieving employee info or retrieving past payrolls.

scope: `company_suspensions:write`

## Path parameters

- `company_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- object
  - `file_quarterly_forms` boolean, required: Should Gusto file quarterly tax forms on behalf of the company? The correct answer can depend on why the company is suspending their account, and how taxes are being reconciled.
  - `file_yearly_forms` boolean, required: Should Gusto file yearly tax forms on behalf of the company? The correct answer can depend on why the company is suspending their account, and how taxes are being reconciled.
  - `reconcile_tax_method` 'pay_taxes' | 'refund_taxes', required: How Gusto will handle taxes already collected.
  - `comments` string: User-supplied comments describing why they are suspending their account. Required if the user is leaving for another provider and selects "other" instead of a defined provider.
  - `reason` 'switching_provider' | 'shutting_down' | 'acquired' | 'no_more_employees' | 'changing_ein_or_entity_type', required: Explanation for why the company is suspending their account. > 🚧 FEIN or entity type changes require Customer Support > If a company is switching FEIN or changing their entity type, this change must be performed by Gusto Customer Support and cannot be performed via the API at this time.
  - `leaving_for` 'accountant' | 'adp' | 'adp_total_source' | 'bamboo_hr' | 'bank_or_financial_institution' | 'check' | 'deel' | 'gusto_com' | 'homebase' | 'insperity' | 'intuit_or_quickbooks' | 'justworks' | 'manual' | 'namely' | 'onpay' | 'other' | 'other_peo' | 'oyster' | 'patriot' | 'paychex' | 'paycom' | 'paylocity' | 'remote' | 'rippling' | 'rippling_peo' | 'sequoia_one' | 'square' | 'surepayroll' | 'toast' | 'trinet' | 'velocity_global' | 'zenefits': The competitor the company is switching to. Required if `reason` is `'switching_provider'`. > 🚧 Switching to Gusto requires Customer Support > If `'gusto_com'` is selected, this change must be completed by Gusto Customer Support and cannot be performed via the API. This endpoint will return a 422 error in that case.

## Response `200`

Successful response

- CompanySuspension: Record representing the suspension of a company's Gusto account.
  - `uuid` string: Unique identifier for this suspension.
  - `company_uuid` string: Unique identifier for the company which is suspended.
  - `effective_date` string: Date that the suspension took effect.
  - `leaving_for` string, nullable: Which competitor the company is joining instead. Only required if `reason` is `'switching_provider'`.
  - `reason` string: Explanation for why the company's account was suspended.
  - `reconcile_tax_method` 'pay_taxes' | 'refund_taxes': How Gusto will handle taxes already collected.
  - `file_quarterly_forms` boolean: Should Gusto file quarterly tax forms on behalf of the company? The correct answer can depend on why the company is suspending their account, and how taxes are being reconciled.
  - `file_yearly_forms` boolean: Should Gusto file yearly tax forms on behalf of the company? The correct answer can depend on why the company is suspending their account, and how taxes are being reconciled.
  - `comments` string, nullable: User-supplied comments describing why they are suspending their account.
  - `tax_refunds` object[]: Describes the taxes which are refundable to the company for this suspension. These may be refunded or paid by Gusto depending on the value in `reconcile_tax_method`.
    - `amount` string: Dollar amount.
    - `description` string: What kind of tax this is.

## Other responses

- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

## Changes

- **2026-11-03** `f98575fa2a5e`: 4 info
  - added the new `other_peo` enum value to the request property `leaving_for`
  - added the new `rippling_peo` enum value to the request property `leaving_for`
  - added the new `sequoia_one` enum value to the request property `leaving_for`
  - added the new `toast` enum value to the request property `leaving_for`

[Operation history](https://skmtc.dev/gusto/apis/gusto-api/changes/v1/companies/:company_uuid/suspensions/post.md)

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)