> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating an Organization

> Set up a new Organization in the Midaz Module.

An Organization is the top-level container for Midaz operations. Create it before creating Ledgers, Assets, Accounts, or Transactions.

## Before you start

***

Confirm the business boundary this Organization should represent. In most setups, it maps to the company, business unit, or regulated entity that owns one or more Ledgers.

<Note>
  If you are setting up Midaz for the first time, follow [Setup path](/en/lerian-console/midaz-console/midaz-console-setup-path) before creating downstream entities.
</Note>

## Create the Organization

***

<Steps>
  <Step>
    Go to the **Organizations** page and click the **New Organization** button.
  </Step>

  <Step>
    The **New Organization** page will open.
  </Step>

  <Step>
    Fill in the required details about the Organization.

    * **Optional**: To include metadata, expand the **Metadata** section. This will reveal fields for **Key** and **Value**.
      * To add additional metadata entries, click the plus (+) sign next to the first row.

    <Tip>
      For more information about the fields in the form, refer to the [Field guide](#field-guide) section.
    </Tip>
  </Step>

  <Step>
    Once all details are entered, click **Create Organization** to finalize.
  </Step>

  <Step>
    Your new Organization will now appear on the Organizations page, ready to be managed and configured!
  </Step>
</Steps>

## Field guide

***

| Field      | What to enter                                                        | Example                  |
| ---------- | -------------------------------------------------------------------- | ------------------------ |
| Legal Name | Official registered name. Use a name operators will recognize later. | `Lerian Payments Brazil` |
| Trade Name | Commercial or customer-facing name.                                  | `Lerian`                 |
| Document   | Official tax ID or registration number. Use numbers only.            | `12345678000190`         |
| Address    | Street name, number, and main address line.                          | `Avenida Paulista, 1234` |
| Complement | Extra address details, such as suite, floor, or apartment.           | `CJ 123`                 |
| Country    | Country where the Organization is registered.                        | `Brazil`                 |
| State      | State, province, or region.                                          | `São Paulo`              |
| City       | City where the Organization is registered.                           | `São Paulo`              |
| ZIP Code   | Postal code. Use numbers only.                                       | `04696040`               |

### Metadata

Optional key-value data used for internal classification, integration references, or reporting.

| Field | What to enter                      | Example       |
| ----- | ---------------------------------- | ------------- |
| Key   | The metadata field name.           | `costCenter`  |
| Value | The value for that metadata field. | `BR_11101997` |

## What to do next

***

After creating the Organization, create its first Ledger in [Creating a new Ledger](/en/lerian-console/midaz-console/creating-a-new-ledger).

<Card title="API equivalent" type="tip" horizontal>
  [Create an Organization endpoint](/en/reference/midaz/create-an-organization)
</Card>