Software Update: Wednesday 26th January 2022 - 07:00-07:30

On Wednesday morning, we're updating OneFile to release some new changes and improvements.

To find out more, our release notes are available 

Please ensure you have saved any work and have logged out prior to 7:00am to avoid any potential loss of data.

Help centre

Submit a ticket Log in

Creating users via the API

Users can be created by calling the POST /api/v2.1/User endpoint.

The following roles are supported in the API:

User RoleRole ID
Trainee Assessor4
Assessor / Tutor5
IV / IQA10

When creating learners, there are more required fields, than when create any other type of user. The required fields are shown below:

Create User (Learner)
POST /api/v2.1/User

"OrganisationID": {Id}
     "First Name": {First Name}
     "Last Name": {Last Name}
     "Role": 1
     "DefaultAssessorID": {Id}
     "ClassroomID": {Id}
     "PlacementID": {Id}
Create User (All Others)
POST /api/v2.1/User

     "OrganisationID": {Id}
     "First Name": {First Name}
     "Last Name": {Last Name}
     "Role": {Role}

Login Details

When the centre setting below is disabled, the API will return the user's UserID, username and password in the body of the response.

When the centre setting below is enabled, the API will only return a 200 OK status. The account will be added to a new/existing Keychain and the user will receive an email to verify their account.

 When creating new accounts, automatically create a new Keychain or attach to an existing Keychain when an email is supplied

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.