---
title: "Create deposit method config"
method: POST
path: "/v1/deposit_method_configs"
tags: ["Deposit Method Configs"]
---

# Create deposit method config

`POST /v1/deposit_method_configs`

Create the configuration to store a deposit method. The configuration contains basic information about the deposit method such as an idempotency key and optional information such as billing contact and metadata. If the billing contact is provided in the deposit method config, then the web component will not prompt for this data. These fields include name for an ACH deposit method. This allows a deposit method to be set up before collecting the sensitive deposit method details (i.e the account number) via the web component.

## Parameters

- `#/paths/~1v1~1deposits/get/parameters/0` — unresolved $ref

## Request body

- Data — unresolved $ref

## Response `200`

OK

- object
  - `status` Status — unresolved $ref
  - `data` object
    - `deposit_method_config_id` string — The unique deposit method config identifier. Prefix is "dmc" in production and "sbx_dmc" in sandbox.
    - `platform_id` string — The unique platform identifier. Prefix is "plt" in production and "sbx_plt" in sandbox.
    - `idempotency_key` string — A unique identifier provided by the platform. This key will be used to detect subsequent retries of the same request. Subsequent requests with the same key will return the result of the first request, regardless if the first request succeeded or failed. This identifier should be generated by the platform and can be max 255 characters.
    - `billing_contact` BillingContact — unresolved $ref
    - `allowed_sources` string[] — The allowed deposit method sources for deposit method creation. If omitted, the allowed sources will default to all the allowed sources set on the platform configuration.
    - `metadata` object — Valid JSON key-value object specified by the platform to store additional information on the payment method. Keys are queryable in list endpoints. Do not use the metadata field to store sensitive or confidential data. Metadata must be less than 8 KB in size.
    - `created_at` string, date-time — Date and time deposit method config was created at in UTC RFC 3339 format.
  - `errors` Errors — unresolved $ref

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `5XX` — unresolved $ref

---

[API](https://skmtc.dev/rainforestpay/apis/authentication.md) · [All operations](https://skmtc.dev/rainforestpay/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rainforestpay/authentication/revisions/529a0dab0f90/schema)