Create user
POST/v1/users
Creates one or more new users in the organization with specified roles and permissions. Unlike the invite endpoint, this creates users directly without requiring them to accept an invitation.
Key Differences from Invite:
- Creates users immediately without invitation flow
- Users are active immediately
- No email invitation is sent
Use Cases:
- Bulk user import from external systems
- Automated user provisioning via integrations
- Pre-creating accounts for known team members
Permissions Required:
- Must have admin role in the organization
- Must have user creation permissions
Request
Responses
- 201
- 400
- 401
- 403
- 409
User(s) created successfully. Returns a mapping of email addresses to their newly created user IDs.
Bad request - Invalid input parameters, malformed email addresses, or missing required fields
Unauthorized - Missing or invalid authentication token
Forbidden - Authenticated but lacking permission to create users in this organization
Conflict - One or more users already exist with the provided email addresses