Importing teams via CSV

Bulk-create teams using a CSV file

Updated on

You can use CSV import to bulk-create teams instead of adding them one by one.

If you also want to import users and assign them to teams, create the teams first with this import, then use the User CSV Import to invite users and assign them.

Where to find it

Go to Teams and click the Import Teams button.

CSV format

Your CSV needs at least a name column. All other columns are optional:

ColumnDescriptionExample
nameTeam name (required)Sales DACH
slugURL slugsales-dach
descriptionTeam descriptionGerman-speaking sales team
primaryColorBrand color (hex)#2563eb
logoUrlLogo image URLhttps://example.com/logo.png
languageLanguage codede
emailAddressTeam contact emailsales@example.com
phonePhone number+49 30 1234567
websiteWebsite URLhttps://example.com
addressPhysical addressMusterstraße 1, Berlin

What happens during import

  • Duplicate names are allowed. Multiple teams can have the same name — each gets its own unique URL slug.
  • A unique URL slug is auto-generated if you don't provide one or if the one you provide is already taken.

After import

You see a summary showing how many teams were created and any errors. Errors are shown per row with the team name and the reason.

Column matching

The import auto-detects columns by common header names in English and German (e.g. Abteilung → name, Beschreibung → description). If auto-detection doesn't match correctly, click Match Your Columns to manually assign CSV columns to the right fields.

Limits

  • Max 200 rows per upload
  • Rate limit: 3 imports per minute

CSV import is available for organizations with the Teams (Workspaces) feature enabled. Only company administrators can perform imports.

Was this article helpful?

Let us know if this article answered your questions.