> ## 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

> [accordion] Create tenant over API
>
> Leverage idemeum [APIs](https://api.idemeum.com) to create child tenants.

> [accordion] Upload tenant CSV file
>
> 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).

## **Upload tenant CSV file**

* Navigate to the admin portal of your parent tenant
* Access `Tenants` section, click `Add tenant` and then `Import CSV`

![Clean Shot 2026 05 25 At 16 57 58@2x](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)

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.