Register Employees

Method registers employees for a test and returns identifiers that can be used to start the test.

Request Information



URI Parameters


Body Parameters

Json with the RegisterParticipantsQuery, see details and example below.

  • center - center unique name. The value can be retrieved from the center details page.
  • validFrom - session link activation time, UTC, ISO 8601.
  • validTill - session link expiration time, UTC, ISO 8601.
  • proctoring - enable proctoring (applicable only for accounts with enabled proctoring)
  • doNotCreateIfExist - do not create new registration if employee has been already registered for center and test
  • tests - from 1 to 10 test identifiers, Guid.
  • employees - from 1 to 500 employees identifiers.

Request Example

Accept: application/json; charset=utf-8
Authorization: SharedKey 99:f52JP7GQd0xqrBzMO1NWTNVGzLENymgdUXu/Ie++NX4=
Content-Type: application/json; charset=utf-8
Content-Length: 349
Date: Thu, 06 Oct 2022 14:15:16 GMT

  "center": "mycenter",
  "validFrom": "2022-10-06T00:00:00Z",
  "validTill": "2022-10-16T23:59:59Z",
  "proctoring": false,
  "doNotCreateIfExist": false,
  "tests": [
  "employees": [
      "id": "willis74"
      "id": "knightly32"
      "id": "covey77"

Date and Authorization headers are constructed in the standard way.

Response Information

HTTP status code

200 OK, 400 Bad Request, etc. according the response processing guide.




Identifiers of registered participants (sessions for employees).

Use the URL mask below to construct a unique link for employee and redirect him to his exam:{center}#participant/{id}

Response Example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Content-Length: 166

  "participantIds": [

To redirect the first participant (willis74) to the assessment you can use URL:

Try Method