---
title: "Create Deposit"
method: POST
path: "/funding/deposits"
tags: ["Deposits"]
---

# Create Deposit

`POST /funding/deposits`

Creates a Deposit.

## Headers

- `Idempotency-Key` string

## Request body

- DepositRequestReq
  - `accountNo` string, required — The user's unique account number, that is human readable.
  - `amount` number, required — The amount that will be deposited into the user's account.
  - `currency` 'USD', required — The name of the currency in abbreviation form.
  - `type` 'ACH' | 'BULK_FUNDING' | 'CASH_PROMOTION' | 'CASH_TRANSFER', required — The method/form in which the funds will be arriving to the user's account.
  - `bankAccountID` string — The unique DriveWealth identifier that identifies each linked bank account.
  - `note` string — A way to store a message/comment on the this object.
  - `iraContribution` 'CURRENT_YEAR' | 'PRIOR_YEAR' | 'POSTPONED_CONTRIBUTION' | 'REPAYMENT' | 'SEC_128_EMPLOYER' | 'OTHER_SOURCE' | 'QUALIFIED_ROLLOVER' | 'PILOT_PROGRAM' | 'QUALIFIED_GENERAL' — The type of contribution deposit for retirement accounts. Note: Trump accounts have their own enums. Click [here](https://developer.drivewealth.com/apis/v1.82.0/reference/enums?isFramePreview=true#trump-contribution-types) for more details.
  - `iraContributionSubType` 'SC' | 'PO' | 'FD' | 'EO' | 'PL' | 'QR' | 'DD' | 'BA' | 'EP' | 'DA' | 'TI' — The sub type to be used for POSTPONED_CONTRIBUTION or REPAYMENT contributions for retirement accounts. Click [here](https://developer.drivewealth.com/apis/reference/enums#ira-contribution-subtypes) for more details.
  - `recurringFrequency` 'BIWEEKLY' | 'DAILY' | 'MONTHLY' | 'MONTHLY_FIRST' | 'MONTHLY_MIDDLE' | 'QUARTERLY' — The recurring deposit frequency; only available for ACH deposits. Note: For retirement accounts, recurring schedules are restricted to CURRENT_YEAR contributions only.
  - `startDate` string — The start date of the recurring deposit. The date should be in the future and within 90 days.
  - `settlementProfileID` string — A settlement profile identifier that links to a specific bank account for fund settlement.
  - `originatorBankDetails` object
    - `bankAccountNumber` string — The account number of the user's external bank account.
    - `bankRoutingNumber` string — The routing number of the user's external bank.
    - `bankName` string — The bank name of the linked account.
    - `bankAddress` string — The full address of the bank where the account is linked.
    - `accountHolderName` string — The full name of the user on the external bank account.
    - `accountHolderAddress` string — The home address of the linked account holder.
    - `accountHolderCountry` string — The country of the linked account holder.
    - `bankCountry` string — The country of the bank where the account is linked.
  - `metadata` object — The metadata object allows for creating a maximum of 5 keys (max 36 characters) and each value cannot exceed more than 128 bytes.

## Response `200`

Creating a User's Account Deposit was successful.

- Deposit
  - `id` string — A unique identifier for the Deposit.
  - `accountNo` string — The user's unique account number, that is human readable.
  - `category` string
  - `currency` 'USD' — The name of the currency in abbreviation form.
  - `amount` number — The amount of cash that is being deposited into the user's account.
  - `status` 'STARTED' | 'PENDING' | 'PROCESSING' | 'SUCCESSFUL' | 'FAILED' | 'OTHER' | 'APPROVED' | 'REJECTED' | 'ON_HOLD' | 'PROCESSING' | 'RETURNED' | '-' — The current status of the user's deposit.
  - `source` object
    - `id` 'ACH' | 'BULK_FUNDING' | 'CASH_PROMOTION' | 'CASH_TRANSFER' — The method/form in which the funds will be arriving to the user's account.
    - `brand` string — A custom description about the type of deposit.
    - `meta_info` string — A way to store a message/note on the deposit object.
  - `created` string
  - `accountID` string — The user's unique account identifier.
  - `userID` string — A unique identifier created for each User on DriveWealth's platform.
  - `transactionCode` 'JOURNAL' | 'FEE_ACH' | 'DISBURSEMENT_ACH_SVB'
  - `wlpFinTranTypeID` string — A unique identifier to id different type of transactions.
  - `iraContribution` 'CURRENT_YEAR' | 'PRIOR_YEAR' | 'POSTPONED_CONTRIBUTION' | 'REPAYMENT' | 'SEC_128_EMPLOYER' | 'OTHER_SOURCE' | 'QUALIFIED_ROLLOVER' | 'PILOT_PROGRAM' | 'QUALIFIED_GENERAL' — The type of contribution deposit for retirement accounts. Note: Trump accounts have their own enums. Click [here](https://developer.drivewealth.com/apis/v1.82.0/reference/enums?isFramePreview=true#trump-contribution-types) for more details.
  - `iraContributionSubType` 'SC' | 'PO' | 'FD' | 'EO' | 'PL' | 'QR' | 'DD' | 'BA' | 'EP' | 'DA' | 'TI' — The sub type to be used for POSTPONED_CONTRIBUTION or REPAYMENT contributions for retirement accounts. Click [here](https://developer.drivewealth.com/apis/reference/enums#ira-contribution-subtypes) for more details.
  - `batch` boolean
  - `recurring` object
    - `id` string — A unique identifier of the recurring deposit.
    - `nextDeposit` string — The date of when the next recurring deposit will be triggered.
    - `active` boolean — True, if the recurring deposit is active.
    - `frequency` 'BIWEEKLY' | 'DAILY' | 'MONTHLY' | 'MONTHLY_FIRST' | 'MONTHLY_MIDDLE' | 'QUARTERLY' — The recurring deposit frequency; only available for ACH deposits. Note: For retirement accounts, recurring schedules are restricted to CURRENT_YEAR contributions only.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/revisions/9fced6d0ac41/schema)