Create and onboard a user
Creates a new user with the given identity, org info and manager, and onboards them via the Zero-Touch (access-template) flow in one step. Omit scheduled_at to provision now; a future timestamp defers provisioning. Nothing is created when onboarding cannot start. Fails if a user with the email already exists — onboard an existing user with POST /users//onboard.
scheduled_at to provision now, or pass a future timestamp to defer it.
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 and onboard parameters
Request body for creating a new user and onboarding them via the Zero-Touch (access-template) flow in one step. The org-info fields are set on the new user so the template rules can match. Omit scheduled_at to provision now; provide a future timestamp to defer provisioning to that date.
Email address
First name
Last name
Manager (user)
Departments the user belongs to
Employment type
full_time, part_time, contract, freelance, internship, apprenticeship, working_student, training Job title
City location
When to provision access. Omitted or null provisions now; a future ISO 8601 timestamp defers it.
Teams the user belongs to
Response
User created and onboarding triggered
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

