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

# Bulk tenant creation

> Create multiple tenants / organizations using CSV upload or API.

## How bulk tenant creation works

<AccordionGroup>
  <Accordion title="Create tenant over API" defaultOpen icon="input-pipe">
    Leverage idemeum [APIs](https://api.idemeum.com) to create child tenants.
  </Accordion>

  <Accordion title="Upload tenant CSV file" defaultOpen icon="upload">
    Upload the CSV file with your organization / customer data. When you are uploading a CSV you need to make sure the CSV contains the fields that will map to organization `name` (will be used in the URL) and `display name` (friendly tenant description).
  </Accordion>
</AccordionGroup>

## **Upload tenant CSV file**

* Navigate to the admin portal of your parent tenant
* Access `Tenants` section, click `Add tenant` and then `Import CSV`
* Upload the CSV file with your tenant data
* Map the values that will be used for `subdomain` and `display name` using the dropdown fields on the right.

<img src="https://mintcdn.com/idemeum/5-NtCVHCZQB-Uvej/images/csv.png?fit=max&auto=format&n=5-NtCVHCZQB-Uvej&q=85&s=cd48a201011c5dfd7613e7301be86a70" alt="Csv" width="1600" height="1134" data-path="images/csv.png" />

* Once you click next, idemeum will process the creation request, and it will create the tenants. Once completed, you will be presented with information for how many tenants were created and what errors were present if any.