Trueability Integration

Overview

The Certiverse–TrueAbility integration lets an organization deliver a TrueAbility hands-on lab (a Performance Based Test, or PBT) as a test part inside a scheduled, proctored Certiverse exam. Certiverse owns booking, proctoring, the test driver and results ; TrueAbility owns the virtual machine (VM), the candidate's tasks and lab scoring. 

User: Organizations that certify hands-on technical skills.

Configuration: Requires a Certiverse Org Admin with access to Certiverse Connectors and access to Exam Management.

Key constraint: TrueAbility exams must be scheduled, normally 24+ hours ahead, because TrueAbility builds the VM before the appointment.

How it works

TrueAbility is a provision-in-advance provider: Certiverse sends the reservation when the booking is made, then hands control to TrueAbility only for the PBT test part. All calls use TrueAbility API v1 with the org's API key; TrueAbility calls back through webhooks Certiverse registers when the exam is activated.

The Certiverse event triggers the TrueAbility call beside it. Final results wait for assessment_finalized, so scores usually appear 10–60 minutes after the candidate finishes.

Prerequisites

Have these in place before configuring anything in Certiverse.

Candidates also need a stable connection and a supported browser, because the lab runs remotely in TrueAbility.

Data schema

Data moves in five groups: connector credentials, exam configuration, the reservation, delivery state, and results. Field names below are the Certiverse labels; TrueAbility JSON property names follow their API v1 docs and should be confirmed against the current spec before sharing externally.

Connector (organization level)

Exam configuration (Exam Management)

Reservation (Certiverse → TrueAbility at booking)

Delivery (stored on the candidate exam)

Results (TrueAbility → Certiverse)

Score formula when a PBT is combined with multiple-choice parts:

\text{Exam raw score} = (\text{PBT weight} \times \text{TrueAbility score}) + \text{MC raw score}

Example: a 50-item MC part with 30 correct, PBT weight 50 and TrueAbility score 0.5 gives 25 + 30 = 55.

Configuration steps

Setup takes four stages: create the connector, configure the exam, configure the form, then set up the store exam. Do them in this order; the exam settings only list connectors that already exist.

1. Create the TrueAbility connector

1. Go to Admin > Connectors > Performance Based Testing
2. Filter by Connection Type Performance Based Testing, or Partner TrueAbility, and select the TrueAbility tile.
3. Provide a Name for the connector.
4. Enter the API Key supplied by TrueAbility.
5. Validate the key and click Create. After saving, only the last 4 characters display.

2. Configure the exam

1. Go to Exam Management, open the exam, and select Advanced Settings gear icon.
2. Under Performance Based Test, turn on Has Performance Based Test.
3. Select TrueAbility as the provider.
   • If you see "This organization has no TrueAbility connectors configured", complete step 1 first. Go to Connectors opens it (Org Admin only).
4. Select the Connector.
5. Select the Ability Screen from the list returned by TrueAbility (shown as Name (ID)).
6. Save or Update.

3. Configure the exam form

1. Open the exam form and add, or select, the test part for the lab.
2. Toggle on Use As Performance Based Test. The Delivery tab then labels it "Performance Based Test". This part cannot hold sections or items.
3. Set the test part scoring type:
   • PBT Provider Determined to use TrueAbility's pass/fail.
   • Otherwise set a PBT Weight (0–1000, up to 4 decimals) so the score combines with any multiple-choice parts.
4. Add multiple-choice test parts if the exam is mixed-format. Only one PBT test part is allowed per form.
5. Approve and activate the form. Once a form is active, the PBT toggle on its test part is locked.

4. Set up the store exam

1. Set delivery to Live Proctored, scheduled.
2. Confirm time slots respect the VM build window: bookings must start at least 24 hours out.
3. To let a specific candidate book sooner, add a Bypass schedule in advance exception for that user and exam. TrueAbility still requires at least 13 hours (12-hour build window + 1).
4. If needed, limit concurrent PBT sessions or bookable days and hours for the exam in the Store Exams configuration.

Testing and validation

Run one end-to-end booking in QA with TrueAbility sandbox Ability Screens before going live, and check each step below.

• Connector saves and validates; key shows masked
• Ability Screen list loads after selecting the connector
• Exam form with the PBT test part approves and activates
• Booking 24+ hours out creates a reservation in TrueAbility (check the TrueAbility admin)
• Cancelling the booking deletes the TrueAbility reservation
• Rescheduling updates the reservation time
• At launch, the PBT test part opens the TrueAbility console
• Proctor chat and controls work while the lab is open
• Proctor add time, pause and resume reach TrueAbility
• "I am done with my Performance Based Test" returns to Certiverse with Resume and Finish options
• Finish Exam stops the TrueAbility assessment (including when paused)
• After assessment_finalized, score and pass/fail appear in the Candidate Results Report
• Mixed-format forms show the correct Reported Score and score report sub-scores

Troubleshooting and FAQ

Can a candidate book an unscheduled or on-demand TrueAbility exam? No. Only scheduled appointments are supported, because the VM is built in advance.

Does a no-show need any action? No. TrueAbility takes the VM offline when it expires (about 4 hours, depending on the lab).

Can each exam form use a different Ability Screen? No. TrueAbility is set at exam level because the reservation is sent at booking, before a form is chosen.

Can PBT exams be rescored in Certiverse? No. Rescoring is blocked for PBT exams and forms; scores come from TrueAbility.

TrueAbility API v1 reference: app.trueability.com/api/docs/v1.

Contact Us

If you have any questions or need additional assistance, please contact us by either emailing support@certiverse.com or by submitting a ticket from this article.

Updated October 26, 2026 15:26