---
title: "Create a new account."
method: POST
path: "/createAccount"
tags: ["Accounts"]
---

# Create a new account.

`POST /createAccount`

Creates an account under an account holder. An account holder can have [multiple accounts](https://docs.adyen.com/platforms/account-holders-and-accounts#create-additional-accounts).

## Request body

- CreateAccountRequest
  - `accountHolderCode` string, required — The code of Account Holder under which to create the account.
  - `payoutSchedule` 'BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT' | 'BIWEEKLY_ON_1ST_AND_15TH_AT_NOON' | 'BI_DAILY_AU' | 'BI_DAILY_EU' | 'BI_DAILY_US' | 'DAILY' | 'DAILY_6PM' | 'DAILY_AU' | 'DAILY_EU' | 'DAILY_SG' | 'DAILY_US' | 'DEFAULT' | 'EVERY_6_HOURS_FROM_MIDNIGHT' | 'HOLD' | 'MONTHLY' | 'MONTHLY_ON_15TH_AT_MIDNIGHT' | 'WEEKLY' | 'WEEKLY_MON_TO_FRI_AU' | 'WEEKLY_MON_TO_FRI_EU' | 'WEEKLY_MON_TO_FRI_US' | 'WEEKLY_ON_TUE_FRI_MIDNIGHT' | 'YEARLY' — The payout schedule of the prospective account. >Permitted values: `DEFAULT`, `HOLD`, `DAILY`, `WEEKLY`, `MONTHLY`.
  - `payoutScheduleReason` string — The reason for the payout schedule choice. >Required if the payoutSchedule is `HOLD`.

## Response `200`

OK - the request has succeeded.

- CreateAccountResponse
  - `accountCode` string, required — The code of the new account.
  - `accountHolderCode` string, required — The code of the account holder.
  - `payoutSchedule` PayoutScheduleResponse
    - `nextScheduledPayout` string, date-time — The date of the next scheduled payout.
    - `schedule` 'BIWEEKLY_ON_1ST_AND_15TH_AT_MIDNIGHT' | 'BIWEEKLY_ON_1ST_AND_15TH_AT_NOON' | 'BI_DAILY_AU' | 'BI_DAILY_EU' | 'BI_DAILY_US' | 'DAILY' | 'DAILY_6PM' | 'DAILY_AU' | 'DAILY_EU' | 'DAILY_SG' | 'DAILY_US' | 'DEFAULT' | 'EVERY_6_HOURS_FROM_MIDNIGHT' | 'HOLD' | 'MONTHLY' | 'MONTHLY_ON_15TH_AT_MIDNIGHT' | 'WEEKLY' | 'WEEKLY_MON_TO_FRI_AU' | 'WEEKLY_MON_TO_FRI_EU' | 'WEEKLY_MON_TO_FRI_US' | '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.
  - `status` 'Active' | 'Closed' | 'Inactive' | 'Suspended', required — The status of the account. >Permitted values: `Active`.
  - `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

- `202` — Accepted - the request has been accepted for processing, but the processing has not been completed.
- `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-11-12** (v3) `cb55a78d7ec2` — 6 warning, 3 info
  - added the new `WEEKLY_MON_TO_FRI_AU` enum value to the `payoutSchedule/schedule` response property for the response status `200`
  - added the new `WEEKLY_MON_TO_FRI_AU` enum value to the `payoutSchedule/schedule` response property for the response status `202`
  - added the new `WEEKLY_MON_TO_FRI_EU` enum value to the `payoutSchedule/schedule` response property for the response status `200`
  - added the new `WEEKLY_MON_TO_FRI_EU` enum value to the `payoutSchedule/schedule` response property for the response status `202`
  - …5 more
- **2021-08-30** (v3) `9ed7f1a91be0` — 6 warning, 3 info
  - added the new `BI_DAILY_AU` enum value to the `payoutSchedule/schedule` response property for the response status `200`
  - added the new `BI_DAILY_AU` enum value to the `payoutSchedule/schedule` response property for the response status `202`
  - added the new `BI_DAILY_EU` enum value to the `payoutSchedule/schedule` response property for the response status `200`
  - added the new `BI_DAILY_EU` enum value to the `payoutSchedule/schedule` response property for the response status `202`
  - …5 more
- **2021-08-07** (v3) `9ca745af6f06` — 1 info
  - api tag `Accounts` added
- **2021-07-09** (v3) `178852251c31` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BasicAuth` was added to the API
- …earlier changes not shown

[Full history](https://skmtc.dev/adyen/apis/accountservice/changes/createAccount/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/cb55a78d7ec2/schema)