---
title: "Create Wallet"
method: POST
path: "/wallets"
tags: ["Wallets"]
---

# Create Wallet

`POST /wallets`

Creates a new wallet provider that can be used for disbursements. The wallet must be configured with supported assets and proper authentication domains.

## Request body

- CreateWalletRequest
  - `name` string, required — Human-readable name of the wallet provider
  - `homepage` string, required — Homepage URL of the wallet provider
  - `deep_link_schema` string, required — Deep link schema for the wallet application
  - `sep_10_client_domain` string, required — SEP-10 client domain for authentication
  - `enabled` boolean — Whether the wallet is enabled for use
  - `assets` union[] — Array of asset references supported by this wallet
    - union
      - object — Asset reference by ID
        - `id` string, required — Asset ID
      - object — Classic asset reference
        - `type` 'classic', required
        - `code` string, required — Asset code
        - `issuer` string, required — Asset issuer address
      - object — Native XLM asset reference
        - `type` 'native', required
  - `assets_ids` string[] — Legacy: Array of asset IDs (cannot be used with assets field)

## Response `201`

Wallet created successfully

- Wallet
  - `id` string
  - `name` string
  - `homepage` string
  - `sep_10_client_domain` string
  - `deep_link_schema` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict - wallet name, homepage, or deep link schema already exists

---

[API](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api.md) · [All operations](https://skmtc.net/stellar/apis/stellar-disbursement-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stellar/stellar-disbursement-platform-api/revisions/39f9dc64156c/schema)