Create Domain User
Syteca ACB REST API endpoint to link an existing Active Directory user to Syteca — for AD-integrated provisioning workflows.
https://{hostname}/EkranACB server in the Playground.Permissions required
The Access Token must be issued to a user with the administrative User Management permission.Prerequisites
- The AD user must already exist in a domain reachable by the Syteca Application Server.
- The domain must be configured in Syteca — see LDAP/AD integration.
Common use cases
- AD-driven onboarding — Group membership changes in AD (e.g. user added to a “PrivilegedAdmins” group) trigger this endpoint to register the user in Syteca.
- AD group sync — Syncing Syteca user groups against AD group memberships nightly.
- Compliance audit prep — Bulk-link all AD users in a privileged role group to Syteca before an audit window.
Errors
See Status codes. Common errors:- 400 Bad Request — invalid user identifier or missing required fields.
- 403 Forbidden — user lacks administrative User Management permission.
- 409 Conflict — AD user is already linked to Syteca.
- 422 Unprocessable Entity — the AD domain referenced isn’t configured in Syteca.
Related
Create internal user
Get user details
Update admin permissions
Update client access
Authorizations
Access token for authentication
Body
AD user name
The lifetime of an access token in seconds for this user
AD domain name
Allow this user account to be used by external applications
Allowed IP address for this user's API access
IP address
Enable two-factor authentication on login
IDs of Syteca user groups, the domain user should be added
Syteca user group ID
Response
Domain user added successfully
Unique Syteca user ID
User type
Domain account name
AD domain name
Two-factor authentication on login
Allow this user account to be used by external applications
The lifetime of an access token in seconds for this user
Allowed IP address for this user's API access
IP address
List of Syteca user group IDs this user belongs to
Syteca user group ID
The user is a member of any user groups