Creating a Holder

Create a new Holder in the Midaz Module as an Individual or Corporate record to represent the person or company that owns one or more Accounts.

A Holder represents the person or company behind one or more Accounts. Create the Holder before you create Alias Accounts. An Alias Account connects customer-facing account information to a ledger Account.

Before you start

---

Decide whether the Holder is an Individual or Corporate record. The type you choose controls which identity and registration fields the form shows.

Create the Holder

---

1. Go to the Holders page. Click the New Holder button.

2. A window opens. Choose the Holder type you want to create.

   • If you select Individual (Natural Person), the New Holder page opens for you to enter the individual’s information.
   • If you select Corporate (Legal Person), the New Holder page opens for you to enter the company’s information.
3. Follow the on-screen instructions to enter the required information. Click Create Holder.

4. When the creation succeeds, you see a confirmation message. The list refreshes and shows the new Holder.

Field guide

---

Individual

Basic Information

Field	What to enter	Example
External ID	Optional ID from your CRM, core banking, KYC, or customer system.	customer_123
Holder type	A read-only field that indicates the type of Holder.	Natural Person
Name	The full name of the Holder.	John Doe
Document	Tax ID, national ID, or company registration number expected by your operation.	12345678900

Contact Information

Field	What to enter	Example
Primary Email	The main email used to contact the Holder.	[e-mail]
Secondary Email	An alternative email used to contact the Holder.	[e-mail]
Mobile Phone	Contact phone number, including country or area code when required.	[phone]
Other Phone	An alternative phone number, including country or area code when required.	[phone]

Addresses

Field	What to enter	Example
Address Line 1	Street name and building number.	Rua Botucatu 10
Address Line 2	Extra address details, for example, apartment or suite number.	Casa B
Zip Code	Postal or ZIP code.	04023060
City	City where the address is located.	São Paulo
State	State, province, or region.	SP
Country	Two-letter country code (ISO 3166-1 alpha-2).	BR

Personal Details

Field	What to enter	Example
Favorite Name	Nickname or preferred name.	Johnny
Social Name	Social name, if different from the legal name.	Johnny Doe
Gender	Gender identity of the person.	Male
Birth Date	Date of birth in YYYY-MM-DD format.	1990-01-01
Civil Status	Civil status — for example: Single, Married, or Divorced.	Married
Nationality	Nationality, for example, Brazilian.	Brazilian
Mother’s Name	Mother’s full name.	Jane Doe
Father’s Name	Father’s full name.	Richard Doe
Status	Current status of the individual in the system.	Active

Metadata

Field	What to enter	Example
Key	Optional classification or integration field name.	kycStatus
Value	Value for the metadata key.	approved

Corporate

Basic Information

Field	What to enter	Example
External ID	Optional ID from your CRM, core banking, KYC, or customer system.	company_123
Type	A read-only field that indicates the type of Holder.	Legal Person
Name	The name of the company in the system.	ACME
Document	Tax ID, national ID, or company registration number expected by your operation.	59014899000183

Contact Information

Field	What to enter	Example
Primary Email	The main email used to contact the company.	[e-mail]
Secondary Email	An alternative email used to contact the Holder.	[e-mail]
Mobile Phone	Contact phone number, including country or area code when required.	[phone]
Other Phone	An alternative phone number, including country or area code when required.	[phone]

Addresses

Field	What to enter	Example
Address Line 1	Street name and building number.	Rua Silva 100
Address Line 2	Extra address details, for example, apartment or suite number.	Cj 12
Zip Code	Postal or ZIP code.	04013060
City	City where the address is located.	São Paulo
State	State, province, or region.	SP
Country	Two-letter country code (ISO 3166-1 alpha-2).	BR

Company Details

Field	What to enter	Example
Trade Name	The registered business name of the company, if applicable.	ACME BR
Activity	The type of business or activity the company engages in.	Electronic devices development
Legal Type	The legal structure of the company.	Limited Liability
Founding Date	The date when the company was established, in YYYY-MM-DD format.	2025-01-01
Company Size	The size classification of the company.	Medium
Status	Current status of the company in the system.	Active
Representative Name	The legal representative’s name.	Jane Doe
Representative Document	The document number of the legal representative.	43522116992
Representative Email	The email address of the legal representative.	[e-mail]
Role	The role of the legal representative within the company.	CFO

Metadata

Field	What to enter	Example
Key	Optional classification or integration field name.	kycStatus
Value	Value for the metadata key.	approved

What to do next

---

After you create the Holder, create an Alias Account to connect the Holder to a Midaz ledger Account. See Creating an Alias Account.

API equivalent

Create Holder endpoint