---
title: "Create a Deposit"
method: POST
path: "/v1/deposits/create/api-key"
tags: ["Deposits"]
---

# Create a Deposit

`POST /v1/deposits/create/api-key`

Creates a new deposit. A deposit can be configured with optional payment methods (card payments, wallet connect, manual transfer) and notification settings. The request must include exactly one currencyId in the currencyIds array.

## Query parameters

- `apiKey` string, required

## Request body

- CreateDeposit — Request body for creating a deposit.
  - `name` string, required — Name of the deposit.
  - `description` string — Optional description of the deposit.
  - `currencyIds` string[], required — Array containing exactly one currency ID. This value can be retrieved using the Currencies endpoint.
  - `notifyReceiverByEmail` boolean — Send email notifications.
  - `connectWalletOptions` DepositPaymentOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
  - `transferManuallyOptions` DepositPaymentOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
  - `payWithCardOptions` DepositPaymentCardOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
    - `hasWhiteListDomain` boolean — Whether a whitelist domain is set.
  - `connectExchangeOptions` DepositPaymentOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
  - `disabledBlockchainSymbols` string[] — List of blockchain symbols for which deposits are disabled.
  - `minSweepAmountUsd` number — Minimum sweep amount in USD.

## Response `200`

Deposit created successfully.

- DepositResponse — Response body for a deposit.
  - `id` string, required — Unique identifier of the deposit.
  - `name` string, required — Name of the deposit.
  - `description` string — Description of the deposit.
  - `paylinkId` string — Associated paylink identifier.
  - `platform` 'HELIO' | 'MAGIC_EDEN', required — Platform associated with the deposit.
  - `notifyReceiverByEmail` boolean, required — Whether the receiver is notified by email.
  - `disabled` boolean, required — Whether the deposit is disabled.
  - `disabledBlockchainSymbols` string[] — List of blockchain symbols for which deposits are disabled.
  - `connectWalletOptions` DepositPaymentOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
  - `transferManuallyOptions` DepositPaymentOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
  - `payWithCardOptions` DepositPaymentCardOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
    - `hasWhiteListDomain` boolean — Whether a whitelist domain is set.
  - `connectExchangeOptions` DepositPaymentOption — Configuration for a deposit payment option.
    - `isActive` boolean — Whether this option is shown/enabled.
    - `title` string — Display title for this option.
    - `badge` string — Optional badge label for this option.
    - `order` number — Display order for this option.
  - `minSweepAmountUsd` number — Minimum sweep amount in USD.
  - `createdAt` string, date-time, required — Timestamp when the deposit was created.
  - `updatedAt` string, date-time, required — Timestamp when the deposit was last updated.

## Other responses

- `401` — Provided API key has no access to the resource.

---

[API](https://skmtc.net/hel/apis/helio-open-api.md) · [All operations](https://skmtc.net/hel/apis/helio-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hel/helio-open-api/versions/5732beb2d39f/schema)