---
title: "Create Wallet"
method: POST
path: "/connected-deposits/{version}/wallets/create"
tags: ["Wallets"]
---

# Create Wallet

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

## Request

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

Create a wallet for person. If the person is already created, send an existing Person GUID.

## Path parameters

- `version` string, required

## Headers

- `IdempotencyKey` string, uuid, required

## Request body

- CreateWalletRequest
  - `account_currencies` string[], nullable: Currencies used in the wallet. Defaults to USD if none selected.
  - `person_guid` string, uuid, required: Person Guid
  - `program_guid` string, uuid, required: Program Guid

## Response `201`

Returns the newly created Wallet

- WalletDTO
  - `wallet_guid` string, uuid: Unique identifier of the wallet on the platform.
  - `wallet_id` string, nullable: Unique id of wallet
  - `person_guid` string, uuid: Person Guid
  - `program_guid` string, uuid: Program Guid
  - `program_name` string, nullable: Program Name
  - `program_short_name` string, nullable: Program Short Name
  - `eft_display_name` string, nullable: Display Name
  - `sponsor_name` string, nullable: Sponsor Name
  - `parent_program_guid` string, uuid, nullable: Program Parent Guid
  - `top_program_guid` string, uuid, nullable: Program Top Guid
  - `company_dba_name` string, nullable: Company DBA Name
  - `company_short_name` string, nullable: Company Short Name
  - `account_status` string, nullable: Status of account.
  - `wallet_created` string, date-time, nullable: Date wallet was created
  - `wallet_name` string, nullable: wallet_name
  - `accounts` AccountDTO[], nullable: List of accounts and balance details
    - `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: Open to buy balance (also called Available balance). This is the balance available for authorization or transaction.
    - `ledger_balance` number, double: Ledger balance (also called Account balance). This include funds that are authorized, but not yet cleared.
    - `suspense_balance` number, double: Balance that will be credited to the account after clearing.
    - `advance_account_details` AdvanceAccountDetails
      - `account` AdvanceAccount
    - `account_status` 'SYSTEM' | 'ACTIVE' | 'FREEZE' | 'CLOSED' | 'OPTOUT'
    - `last_txn_guid` string, uuid, nullable: Unique identifier for last posted transaction on the given account.
    - `post_date` string, date-time, nullable: Last transaction posted date in UTC.
    - `amount` number, double, nullable: Amount corresponding to the last posted transaction.
    - `mask_account_number` string, nullable: Last four digits of account number
    - `sys_utcinserted` string, date-time
    - `status_change_nonmon_detail` TxnNonmonDetail
  - `cards` CardDTO[], nullable: List of cards
    - `card_proxy` string, nullable: Card proxy
    - `wallet_guid` string, uuid: Unique ID of the wallet associated with the card.
  - `account_instruments` AccountInstrumentDTO[], nullable: List of instruments associated with the
    - `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_shared_persons` AccountSharedPersonDTO[], nullable: List of account shares.
    - `holder_person_guid` string, uuid
    - `related_person_guid` string, uuid

## Other responses

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

---

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