Skip to content
English
Sign in
Contact us
  • There are no suggestions because the search field is empty.

Development API (Assessio AI API)

The Development API enables Assessio AI and in the future external platforms to integrate directly with Assessio Platform (AP) for the purpose of initiating and receiving assessment data for their employees.

1. Setup Requirements

Create an organization in Assessio Platform

Assessio AI or another external system must connect to an existing AP organization.

Use the Development Integration Wizard

The wizard contains a single configuration step where the admin:

  1. Selects the integration type

  2. Generates an API token

At present, the only supported integration type is Assessio AI.

Once the token is created and the integration is active, the external platform can request Assessments the Development API.

2. Assessment Request Workflow

When an external platform requests an assessment

The client platform triggers either:

  • A MAP assessment, or

  • A Values assessment

(Users may complete both, but they are requested and completed separately.)

AP receives the request and processes it using the provided email address.
Two scenarios determine what happens next:

A. Email does not exist in AP

If the user does not already exist:

  • A new user is created as an employee in the AP organization.

  • An assessment link is generated and returned to the client platform.

Important:
New users are created silently — AP does not send account-creation emails.
This prevents confusion since users interact entirely through the client platform, not AP.

B. Email already exists in AP

If the email is already associated with an employee in AP:

  • No account changes are made

  • A new assessment link is generated and returned

  • The existing user retains their current profile and history

3. Completing the Assessments

Newly created users:

When the person clicks the link:

  1. They complete their MAP or Values assessment

  2. They land on an assessment results page

  3. AP immediately sends the completed assessment data back to the client platform

  4. A “Return to Client Platform” button redirects them seamlessly

  5. If they click the link again later, they see a re-use modal, allowing them to:

    • Re-take the assessment, or

    • Re-use previous data

Existing users:

Existing users follow the same process except:

  • They always start with the re-use modal

  • They choose whether to:

    • Re-take the assessment, or

    • Use existing data

  • After completion or re-use, results are returned to the client platform