---
title: "Update a company's payment configs"
method: PUT
path: "/v1/companies/{company_uuid}/payment_configs"
tags: ["Payment Configs"]
---

# Update a company's payment configs

`PUT /v1/companies/{company_uuid}/payment_configs`

## Request

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

Update payment speed, fast payment limit, and/or partner-owned disbursement for a company.

At least one of `payment_speed`, `fast_payment_limit`, or `partner_owned_disbursement` is required.
1-day payment speed is only applicable to partners that opt in. 1-day is not allowed when AutoPilot is enabled.

### Related guides
- [Payroll Processing Speeds](doc:2-day-vs-4-day)

scope: `company_payment_configs:write`

## Path parameters

- `company_uuid` string, required

## Headers

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

## Request body

- PaymentConfigsUpdateRequest: Request body for updating company payment configs. At least one of payment_speed, fast_payment_limit, or partner_owned_disbursement is required.
  - `payment_configs` object
    - `payment_speed` '1-day' | '2-day' | '4-day': Desired payment speed. 1-day is only applicable to partners that opt in.
    - `fast_payment_limit` number, nullable: Payment limit for 1-day or 2-day payroll (in dollars). Applies to the 24-hour aggregate of all payments; a payment that exceeds it moves to 4-day.
    - `partner_owned_disbursement` boolean: Whether to use the partner-owned disbursement payment rail.

## Response `200`

Successful

- PaymentConfigs
  - `company_uuid` string: Company uuid
  - `partner_uuid` string: Partner uuid
  - `fast_payment_limit` string, nullable: Payment limit for 1-day or 2-day payroll (string representation of decimal). Applies to the 24-hour aggregate of all payments; a payment that exceeds it moves to 4-day.
  - `payment_speed` '1-day' | '2-day' | '4-day': Payment speed. READ-ONLY. - `1-day`: Next-day ACH (only for partners that opt in). - `2-day`: Two-day ACH. - `4-day`: Standard ACH.
  - `partner_owned_disbursement` boolean: Whether the company is configured to use the partner-owned disbursement payment rail
  - `earned_fast_ach_blockers` object[]: Blockers preventing the company from earning fast ACH payments
    - `blocker_type` 'minimum_days' | 'minimum_funded_payments': The type of blocker
    - `threshold` number: The threshold needed to unblock

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `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.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)