Create a user
Creates a new user with the given identity and org info (department/team/job_title/location/employment_type + manager). Does not onboard — call POST /users/:user_id/onboard to onboard. Fails if a user with the email already exists.
Authorizations
Bearer token authentication. Pass your AccessOwl API token in the Authorization header as Bearer <token>.
Headers
Optional key (1–255 chars) for safely retrying a request. Reusing the same key for the same request returns 409 Conflict and is not processed again — this confirms the request was already received. Keys are retained for 14 days.
1 - 255Body
Create user parameters
Request body for creating a new user. The org-info fields are set on the new user. Does not onboard — call POST /users/{user_id}/onboard afterwards, or create and onboard in one step with POST /users/onboard.
Email address
First name
Last name
Departments the user belongs to
Employment type
full_time, part_time, contract, freelance, internship, apprenticeship, working_student, training Job title
City location
Manager (user)
Teams the user belongs to
Response
User created
A user in the organization
Email address
First name
User ID
Last name
Current status
active, inactive, onboarding, onboarding_provisioning_planned, offboarding, offboarding_planned, offboarded Deactivation timestamp
Departments the user belongs to
Employment type
full_time, part_time, contract, freelance, internship, apprenticeship, working_student, training Full name (computed)
Creation timestamp
Job title
City location
Manager user ID
Teams the user belongs to
Last update timestamp

