---
title: "Create AccountInstrument"
method: POST
path: "/connected-deposits/{version}/account-instruments/create"
tags: ["AccountInstruments"]
---

# Create AccountInstrument

`POST /connected-deposits/{version}/account-instruments/create`

## Request

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

Create a AccountInstrument and generate an `account_number`.

## Path parameters

- `version` string, required

## Headers

- `IdempotencyKey` string, uuid, required

## Request body

- CreateAccountInstrumentRequest
  - `account_guid` string, uuid, required: Unique identifier of the account on the platform.

## Response `201`

Returns the newly created AccountInstrument

- AccountInstrumentDTO
  - `routing_number` string, nullable: For DDA types bank identification routing number
  - `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_info` BankAccount
    - `account_type` 'DDA' | 'CHECKING' | 'SAVING', required: Bank Account type must be DDA, CHECKING or SAVING. DDA will be deprecated using CHECKING, SAVING and DDA selection defaults to CHECKING
    - `account_number` string, required: Bank Account number
    - `routing_number` string, nullable: For DDA types bank identification routing number
    - `bank_address` AddressDTO: Address details
      - `city` string, nullable: City corresponding to the address
      - `country` string, nullable: Country corresponding to the address. Must be entered as ISO 3-letter country code.
      - `address_line1` string, nullable: Address information of the person. Full number and name of street, avenue, road etc
      - `address_line2` string, nullable: Additional address information
      - `postal_code` string, nullable: Postal code corresponding to the address.
      - `state` string, nullable: State name
  - `mask_account_number` string, nullable: Last four digits of account number
  - `instrument_type` 'BANKDDA' | 'IBAN' | 'BBAN' | 'CARD' | 'CHECK'
  - `instrument_status` 'ACTIVE' | 'SUSPEND' | 'NEGLIST' | 'FORGET' | 'UNPROVED' | 'REPLACED'

## Other responses

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

---

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