# Create a FinancialAccount object

Creates a new FinancialAccount.

## Parameters

- `type` (enum, required)
  The type of FinancialAccount to create.
Possible enum values:
  - `storage`
    Used for the long term storage of funds and sending those funds to others.

- `metadata` (map, optional)
  Metadata associated with the FinancialAccount.

- `storage` (object, optional)
  Parameters specific to creating `storage` type FinancialAccounts.

  - `storage.holds_currencies` (array of enums, required)
    The currencies that this FinancialAccount can hold.

## Returns

## Response attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string, value is "v2.money_management.financial_account")
  String representing the object’s type. Objects of the same type share the same value of the object field.

- `balance` (object)
  Multi-currency balance of this FinancialAccount, split by availability state. Each balance is represented as a hash where the key is the three-letter ISO currency code, in lowercase, and the value is the amount for that currency.

  - `balance.available` (map)
    Balance that can be used for money movement.

  - `balance.inbound_pending` (map)
    Balance of inbound funds that will later transition to the `available` balance.

  - `balance.outbound_pending` (map)
    Balance of funds that are being used for a pending outbound money movement.

- `country` (enum)
  Two-letter country code that represents the country where the LegalEntity associated with the FinancialAccount is based in.

- `created` (timestamp)
  Time at which the object was created.

- `livemode` (boolean)
  Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.

- `metadata` (map, nullable)
  Metadata associated with the FinancialAccount

- `other` (object, nullable)
  If this is a `other` FinancialAccount, this hash indicates what the actual type is. Upgrade your API version to see it reflected in `type`.

  - `other.type` (string)
    The type of the FinancialAccount, represented as a string. Upgrade your API version to see the type reflected in `financial_account.type`.

- `status` (enum)
  An enum representing the status of the FinancialAccount. This indicates whether or not the FinancialAccount can be used for any money movement flows.
Possible enum values:
  - `closed`
    The FinancialAccount is closed and cannot be used anymore.

  - `open`
    The FinancialAccount is open and available for use.

  - `pending`
    The FinancialAccount was created and is in the process of being opened.

- `status_details` (object, nullable)
  - `status_details.closed` (object, nullable)
    - `status_details.closed.forwarding_settings` (object, nullable)
      - `status_details.closed.forwarding_settings.payment_method` (string, nullable)
        The address to send forwarded payments to.

      - `status_details.closed.forwarding_settings.payout_method` (string, nullable)
        The address to send forwarded payouts to.
    - `status_details.closed.reason` (enum)Possible enum values:
      - `account_closed`
        The FinancialAccount is closed by stripe

      - `closed_by_platform`
        The FinancialAccount is closed by platform

- `storage` (object, nullable)
  If this is a `storage` FinancialAccount, this hash includes details specific to `storage` FinancialAccounts.

  - `storage.holds_currencies` (array of enums)
    The currencies that this FinancialAccount can hold.

- `type` (enum)
  Type of the FinancialAccount. An additional hash is included on the FinancialAccount with a name matching this value. It contains additional information specific to the FinancialAccount type.
Possible enum values:
  - `other`
    The API version used does not support the FinancialAccount’s type.

  - `storage`
    Used for the long term storage of funds and sending those funds to others.

## Error Codes

| HTTP status code | Code                         | Description                                                      |
| ---------------- | ---------------------------- | ---------------------------------------------------------------- |
| 400              | already_exists               | The resource already exists.                                     |
| 400              | financial_account_open_limit | The compartment has reached its limit on open FinancialAccounts. |
| 400              | storer_capability_missing    | The required storer capabilities are missing.                    |
| 400              | storer_capability_not_active | The required storer capabilities are not active.                 |
| 400              | unsupported_currency         | The currency is not supported for Financial Accounts.            |
| 409              | idempotency_error            | An idempotent retry occurred with different request parameters.  |

```curl
curl -X POST https://api.stripe.com/v2/money_management/financial_accounts \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2025-07-30.preview" \
  --json '{
    "type": "storage",
    "storage": {
        "holds_currencies": [
            "usd"
        ]
    },
    "metadata": {
        "nickname": "My Financial Account"
    }
  }'
```

### Response

```json
{
  "id": "fa_65So897Og7nsSRgcz1L16SmeOD0tE9TfqsMPW2uZH3IEky",
  "object": "v2.money_management.financial_account",
  "balance": {
    "available": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    },
    "inbound_pending": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    },
    "outbound_pending": {
      "usd": {
        "value": 0,
        "currency": "usd"
      }
    }
  },
  "country": "US",
  "created": "2025-06-27T21:52:05.197Z",
  "metadata": {
    "nickname": "My Financial Account"
  },
  "other": null,
  "status": "pending",
  "storage": {
    "holds_currencies": [
      "usd"
    ]
  },
  "type": "storage",
  "livemode": true
}
```