# Create Address

Create a new address.

Endpoint: POST /api/v1/vaults/{id}/addresses
Version: 0.2.0
Security: bearerAuth

## Path parameters:

  - `id` (string, required)
    ID of the vault to create address in.

## Request fields (application/json):

  - `name` (string)
    The name of the address.

  - `address_type` (string)
    The type of the address.
    Enum: "legacy", "segwit", "taproot"

  - `import_address` (object)
    Additional information when creating an address from an imported key. This field is relevant only for organizations using imported keys.Imported addresses much be either of type LEGACY or SEGWIT.

  - `import_address.derivation_path` (string, required)
    The BIP-32 derivation path of the address.
    Example: "m/44/60/0/0/0"

## Response 201 fields (application/json):

  - `id` (string, required)
    The unique identifier of the object in the Fordefi platform.

  - `created_at` (string, required)
    The date and time when the object was created.

  - `modified_at` (string, required)
    The date and time when the object was last modified. Any change to any field of the resource is considered a modification.

  - `vault` (object, required)
    The vault this address belongs to.

  - `vault.id` (string, required)
    The unique identifier of the vault in the Fordefi platform.

  - `vault.vault_group_id` (string, required)
    The unique identifier of the vault group this vault belongs to.

  - `vault.name` (string, required)
    The name of the vault.

  - `vault.address` (string)
    The address of the vault.

  - `vault.state` (string, required)
    State of the vault.
    Enum: "active", "archived"

  - `vault.type` (string, required)
    Type of the vault.
    Enum: "aptos", "black_box", "cosmos", "evm", "solana", "stacks", "starknet", "sui", "ton", "tron", "utxo", "exchange"

  - `vault.logo_url` (string)
    The logo of the vault. Supported only for exchange vaults.

  - `vault.end_user` (object)
    The end user that owns this vault if it is in a Consumer Wallet organization.  otherwise.

  - `vault.end_user.id` (string, required)
    The unique identifier of the user in the Fordefi platform.

  - `vault.end_user.user_type` (string, required)
    The type of the user.

  - `vault.end_user.external_id` (string, required)
    External id of the user.
    Example: "user|1234"

  - `vault.end_user.state` (string, required)
    The state of the user.
    Enum: "active", "deleted"

  - `name` (string, required)
    The name of the address.

  - `public_key_compressed` (string, required)
    The compressed public key of the address. As defined in the SEC1 standard: https://www.secg.org/SEC1-Ver-1.0.pdf.
    Example: "SGVsbG8="

  - `derivation_path` (string, required)
    The BIP-32 derivation path of the address.
    Example: "m/44/60/0/0/0"

  - `type` (string, required)
    The type of the vault address.

  - `address` (object, required)
    The address on the chain.

  - `address.address` (string, required)
    The UTXO string address.
    Example: "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq"

  - `address.address_type` (string, required)
    The type of the address.
    Enum: "legacy", "p2sh", "segwit", "taproot"

  - `address.chain` (object, required)
    The UTXO chain unique ID.

  - `address.chain.chain_type` (string, required)
    The type of the chain.

  - `address.chain.unique_id` (string, required)
    The UTXO chain unique ID.
    Enum: "bitcoin_mainnet", "bitcoin_testnet"

## Response 400 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

  - `system_error_code` (string)
    An additional system error code in Fordefi.

  - `error_type` (string)
    Enum: "invalid_vault_type"

## Response 401 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 403 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 404 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

  - `resource` (string)
    The type of resource.
    Enum: "user", "user_change_proposals", "user_group", "user_group_change_proposal", "vault", "vault_address", "vault_group", "address_group", "transaction", "batch_transaction", "path", "keyset", "auth_token", "access_token", "asset", "asset_info", "vault_derivation_path", "blockchain", "export", "quote", "import_keys_request", "vault_address_account", "exchange_asset_mapping"

## Response 408 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 422 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (array, required)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.

## Response 500 fields (application/json):

  - `title` (string, required)
    Human-readable error message.

  - `detail` (string, required)
    Detailed error message.

  - `full_detail` (string)
    Full error message with additional details, if available.

  - `request_id` (string)
    Request ID - for debugging purposes.