# Create

**POST /shared-wallets**

<p align="right">status: <strong>stable</strong></p>
Create a shared wallet from either an account public key and script
templates or mnemonic and script templates.



## Servers
- https://localhost:8090/v2: https://localhost:8090/v2 ()



## Parameters



## Body parameters
Content-type: application/json

- **name** (string)
  
- **mnemonic_sentence** (array[string(bip-0039-mnemonic-word{english})])
  A list of mnemonic words
- **mnemonic_second_factor** (array[string(bip-0039-mnemonic-word{english})])
  An optional passphrase used to encrypt the mnemonic sentence.
- **passphrase** (string)
  A master passphrase to lock and protect the wallet for sensitive operation (e.g. sending funds)
- **account_index** (string)
  An individual segment within a derivation path.

The `H` suffix indicates a _Hardened_ child private key, which
means that children of this key cannot be derived from the public
key. Indices without a `H` suffix are called _Soft_.

- **payment_script_template** (object)
  
- **delegation_script_template** (object)
  
- **script_validation** (string)
  Script validation level. Required validation sifts off scripts that would not
be accepted by the ledger. Recommended level filters out scripts that do not pass
required validation and additionally when:
  * 'all' is non-empty
  * there are redundant timelocks in a given level
  * there are no duplicated verification keys in a given level
  * 'at_least' coefficient is positive
  * 'all', 'any' are non-empty and `'at_least' has no less elements in the list
     than the coefficient after timelocks are filtered out.

- **one_change_address_mode** (boolean)
  

## Responses
### 415: Unsupported Media Type

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when providing an invalid 'Content-Type' header.
- **code** (string)
  

### 409: Conflict

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when a otherwise valid request would yield a wallet that already exists.
- **code** (string)
  

### 406: Not Acceptable

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when providing an invalid 'Accept' header.
- **code** (string)
  

### 400: Bad Request

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when a request is not well-formed; that is, it fails to parse
successfully. This could be the case when some required parameters
are missing or, when malformed values are provided.

- **code** (string)
  

### 403: Forbidden

#### Body Parameters: application/json (object)
- **message** (string)
  Returned when a user tries to create a shared wallet with script template
that does not pass validation.

- **code** (string)
  

### 500: Forbidden

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when there is a missing reward account but wallet participates in staking.
- **code** (string)
  

### 201: Created

#### Body Parameters: application/json (object)
- **id** (string(hex))
  A unique identifier for the wallet
- **name** (string)
  
- **account_index** (string)
  An individual segment within a derivation path.

The `H` suffix indicates a _Hardened_ child private key, which
means that children of this key cannot be derived from the public
key. Indices without a `H` suffix are called _Soft_.

- **address_pool_gap** (integer)
  Number of consecutive unused addresses allowed.

**IMPORTANT DISCLAIMER:** Using values other than `20` automatically makes your wallet invalid with regards to BIP-44 address discovery. It means that you **will not** be able to fully restore
your wallet in a different software which is strictly following BIP-44.

Beside, using large gaps is **not recommended** as it may induce important performance degradations. Use at your own risks.

**IMPORTANT DISCLAIMER 2:** There is no way to `import` addresses generated outside (e.g. using cardano-addresses) into the wallet.
Wallet only discovers transactions on its used and unused addresses that are within its currently seen `address_pool_gap`.
Transactions on addresses that "belong" to the wallet but happen to be beyond its `address_pool_gap` will not be visible to the wallet.
This is a technical limitation of the industry standard [BIP-44](https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki). See also [CIP-1852](https://github.com/cardano-foundation/CIPs/blob/master/CIP-1852/CIP-1852.md).

- **payment_script_template** (object)
  
- **delegation_script_template** (object)
  
- **state** (object)
  


[Powered by Bump.sh](https://bump.sh)