An Organization is the top-level container for Midaz operations. Create it before creating Ledgers, Assets, Accounts, or Transactions.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.
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.
If you are setting up Midaz for the first time, follow Setup path before creating downstream entities.
Create the Organization
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.
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.

