---
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`

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' | 'oyster' | 'patriot' | 'paychex' | 'paycom' | 'paylocity' | 'remote' | 'rippling' | 'square' | 'surepayroll' | '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.

---

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