---
title: "Create Account"
method: POST
path: "/connected-deposits/{version}/accounts/create"
tags: ["Accounts"]
---

# Create Account

`POST /connected-deposits/{version}/accounts/create`

## Request

- Base URL: `https://agw-ext.huntington.com`
- URL: `https://agw-ext.huntington.com/connected-deposits/{version}/accounts/create`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/huntington/apis/qolo-api-accounts/docs/connected-deposits/:version/accounts/create/post.ts> (a function with typed inputs; its response is checked against the schema)

Call this end point to create an account on the platform by passing the wallet information.

## Path parameters

- `version` string, required

## Headers

- `IdempotencyKey` string, uuid, required

## Request body

- CreateAccountRequest
  - `account_currencies` string[], nullable: Currencies used in the account. Defaults to USD if none selected.
  - `wallet_guid` string, uuid: Wallet unique identifier.\ ***required*** if person already has a wallet.
  - `person_guid` string, uuid: Persons unique identifier.\ ***required*** if person does not yet have a wallet.
  - `account_name` string, nullable: A user defined name of the account.

## Response `201`

Returns the newly created Account

- CreateAccountResponseDTO
  - `account_instrument` AccountInstrumentDTO
    - `account_instrument_guid` string, uuid: Unique id of instrument associated with account
    - `account_guid` string, uuid: Unique identifier of the account on the platform.
  - `account_guid` string, uuid: Unique identifier of the account on the platform.
  - `wallet_guid` string, uuid: Unique identifier of the wallet on the platform.
  - `account_currency` string, nullable: Currency of account in ISO-3 string format.
  - `account_name` string, nullable: Name of account provided by the API client.
  - `account_type` 'GENERAL' | 'PROGFUND' | 'CHECK' | 'REVENUE' | 'COLLECTION' | 'PRINCIPAL' | 'SECURE' | 'CREDIT' | 'USERDEFINED' | 'ADVANCE' | 'PROG_DISBURSE' | 'EXCEPTION' | 'WRITEOFF' | 'SUSPENSE' | 'OMNI_OFFSET' | 'INTHOLD' | 'OPERATION'
  - `available_balance` number, double
  - `ledger_balance` number, double
  - `suspense_balance` number, double
  - `advance_account_details` AdvanceAccountDetails
    - `account` AdvanceAccount
  - `account_status` 'SYSTEM' | 'ACTIVE' | 'FREEZE' | 'CLOSED' | 'OPTOUT'
  - `last_txn_guid` string, uuid, nullable
  - `post_date` string, date-time, nullable
  - `amount` number, double, nullable
  - `mask_account_number` string, nullable: Last four digits of account number
  - `sys_utcinserted` string, date-time
  - `status_change_nonmon_detail` TxnNonmonDetail

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `404`: Wallet not found
- `500`: Server Error

---

[API](https://skmtc.dev/huntington/apis/qolo-api-accounts.md) - [All operations](https://skmtc.dev/huntington/apis/qolo-api-accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/huntington/apis/qolo-api-accounts/revisions/03b00db451e5?raw)