Import team members in bulk by uploading a CSV file. This is the fastest way to onboard a large group or update existing records.
CSV Format
Your file should include the following columns:
| Column | Required | Description |
|---|---|---|
email | Yes | Work email (must match Slack profile) |
name | No | Full name (aliases: "full name", "employee name", "display name") |
department | No | Department name (aliases: "dept", "team", "division") |
job_title | No | Job title (aliases: "title", "position") |
manager_email | No | Email of the direct manager (aliases: "manager", "reports to") |
level | No | Career level, e.g. Senior, Staff (aliases: "grade", "seniority") |
role | No | System role: admin, hr, manager, or user |
Tip
Column names are flexible -- Nami recognizes common aliases automatically. For example, "Full Name" and "Employee Name" both map to the name field.
Column Mapping
After uploading, Nami shows a mapping screen where you confirm which CSV columns correspond to which Nami fields. Unrecognized columns can be manually mapped or skipped.
Validation
Before applying, Nami checks for:
- Duplicate emails.
- Invalid email formats.
- Invalid role values (must be
user,manager,hr, oradmin). - Manager email references that do not match any existing user.
Errors are displayed inline so you can fix and re-upload.
Warning
Manager resolution uses the manager_email column. Make sure managers are included in the same CSV or already exist in Nami, otherwise the relationship will not be set.
Preview & Apply
After validation passes, you see a preview of all changes (new members, updates, skipped rows). Review carefully, then click Apply Import to finalize.
Info
The importer matches users by email address. Existing users are updated with the new values; unmatched emails will create new user records.
Run this in Slack with Nami
Reviews, goals, surveys, and calibration — in the DM thread your team already reads. Free for teams of 10 or fewer.
More in Team Management