> ## 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 customer tenants at once with CSV upload or APIs.

## How bulk tenant creation works

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

  <Accordion title="Upload tenant CSV file" defaultOpen>
    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`

<img src="https://mintcdn.com/idemeum/I9BOs5FiOrFaoE4O/images/CleanShot-2026-05-25-at-16.57.58@2x.png?fit=max&auto=format&n=I9BOs5FiOrFaoE4O&q=85&s=08a283e0dff0d67723d565b736c2946e" alt="Clean Shot 2026 05 25 At 16 57 58@2x" width="3268" height="2138" data-path="images/CleanShot-2026-05-25-at-16.57.58@2x.png" />

* 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.
* 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.