---
title: "Update an account."
method: POST
path: "/updateAccount"
---

# Update an account.

`POST /updateAccount`

Updates the description or payout schedule of an account.

## Request body

- UpdateAccountRequest
  - `accountCode` string, required — The code of the account to update.
  - `payoutSchedule` UpdatePayoutScheduleRequest, required
    - `action` 'CLOSE' | 'NOTHING' | 'UPDATE' — Direction on how to handle any payouts that have already been scheduled. Permitted values: * `CLOSE` will close the existing batch of payouts. * `UPDATE` will reschedule the existing batch to the new schedule. * `NOTHING` (**default**) will allow the payout to proceed.
    - `reason` string — The reason for the payout schedule update. > This field is required when the `schedule` parameter is set to `HOLD`.
    - `schedule` 'BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT' | 'BIWEEKLY_ON_1ST_AND_15TH_AT_NOON' | 'DAILY' | 'DAILY_6PM' | 'DAILY_AU' | 'DAILY_EU' | 'DAILY_SG' | 'DAILY_US' | 'DEFAULT' | 'EVERY_6_HOURS_FROM_MIDNIGHT' | 'HOLD' | 'MONTHLY' | 'WEEKLY' | 'WEEKLY_ON_TUE_FRI_MIDNIGHT' | 'YEARLY', required — The payout schedule to which the account is to be updated. Permitted values: `DEFAULT`, `HOLD`, `DAILY`, `WEEKLY`, `MONTHLY`. `HOLD` will prevent scheduled payouts from happening but will still allow manual payouts to occur.

## Response `200`

OK - the request has succeeded.

- UpdateAccountResponse
  - `accountCode` string, required — The code of the account.
  - `payoutSchedule` PayoutScheduleResponse
    - `nextScheduledPayout` string, date-time, required — The date of the next scheduled payout.
    - `schedule` 'BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT' | 'BIWEEKLY_ON_1ST_AND_15TH_AT_NOON' | 'DAILY' | 'DAILY_6PM' | 'DAILY_AU' | 'DAILY_EU' | 'DAILY_SG' | 'DAILY_US' | 'DEFAULT' | 'EVERY_6_HOURS_FROM_MIDNIGHT' | 'HOLD' | 'MONTHLY' | 'WEEKLY' | 'WEEKLY_ON_TUE_FRI_MIDNIGHT' | 'YEARLY', required — The payout schedule of the account. >Permitted values: `DEFAULT`, `HOLD`, `DAILY`, `WEEKLY`, `MONTHLY`.
  - `pspReference` string — The reference of a request. Can be used to uniquely identify the request.
  - `resultCode` string — The result code.
  - `submittedAsync` boolean — Indicates whether the request is processed asynchronously. Depending on the request's platform settings, the following scenarios may be applied: * **true**: The request is queued and will be executed when the providing service is available in the order in which the requests are received. * **false**: The processing of the request is immediately attempted; it may result in an error if the providing service is unavailable.

## Other responses

- `400` — Bad Request - a problem reading or understanding the request.
- `401` — Unauthorized - authentication required.
- `403` — Forbidden - insufficient permissions to process the request.
- `422` — Unprocessable Entity - a request validation error.
- `500` — Internal Server Error - the server could not process the request.

## Changes

- **2021-03-26** (v3) `451ffbde20dc` — 1 warning, 1 info
  - added the new `DAILY_SG` enum value to the `payoutSchedule/schedule` response property for the response status `200`
  - added the new `DAILY_SG` enum value to the request property `payoutSchedule/schedule`
- **2021-03-05** (v3) `b04b573249e2` — 1 breaking, 5 info
  - the request property `payoutSchedule` became required
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - …2 more
- **2020-08-05** (v3) `2e73ca0384b4` — 3 breaking, 1 info
  - the response property `payoutSchedule` became optional for the status `200`
  - the response property `pspReference` became optional for the status `200`
  - the response property `submittedAsync` became optional for the status `200`
  - api operation id `post-updateAccount` was added
- **2020-03-04** (v3) `e792ac3ed3c5` — 2 warning, 2 info
  - added the new `DAILY_AU` enum value to the `payoutSchedule/schedule` response property for the response status `200`
  - added the new `DAILY_EU` enum value to the `payoutSchedule/schedule` response property for the response status `200`
  - added the new `DAILY_AU` enum value to the request property `payoutSchedule/schedule`
  - added the new `DAILY_EU` enum value to the request property `payoutSchedule/schedule`
- …earlier changes not shown

[Full history](https://skmtc.dev/adyen/apis/accountservice/changes/updateAccount/post.md)

---

[API](https://skmtc.dev/adyen/apis/accountservice.md) · [All operations](https://skmtc.dev/adyen/apis/accountservice/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/adyen/accountservice/revisions/451ffbde20dc/schema)