GuidesAPI ReferenceChangelog



A Package is essentially a combined group of assessment services that Paylocity's customer has already created on a partners platform. As an example, a Package could be “Personality test” which includes all questions that would be applicable in the personality test for the job. An assessment partner platform can combine several such assessments, which are individual tests, and bundle up into a single assessment package with unique name and ID.

A PUT on the /assessmentPackages endpoint inserts or updates a list of the packages defined for Paylocity's customers. As an assessment partner, you can also remove any package which is not active by using the status value flag, or set end date on the package in order to remove the package information from Paylocity's UI. Paylocity will prevent any future orders using this package id, however, any in-flight assessment orders should still be processed by your platform.

Paylocity can support different assessment packages for every company you partner with. If the company is b6001 in the request URL then the assessmentpackages will be applicable for all the Paylocity companies, however, if you want to send assessment packages at a company level then use the specific companyId in the request which will allow you granular control on your offerings to our mutual customers.


Max length = 36
RequiredThe unique ID of the package.
statusobjectRequiredPackage status. It contains information about package validity.
status.startDateDateTimeRequiredStart date of package validity. For immediate start use DateTime.UtcNow
status.endDateDateTimeOptionalEnd date of package validity. If package doesn’t have expiration date, this field should be null.
status.valueEnumOptionalStatus value. Possible values: “Active, Inactive, Deleted, Unknown”. If value is not provided it will be calculated based on start/end date.

Max length = 250
RequiredA summary of the package.

Max length = 50
RequiredThe name of the package.
assessmentsarrayRequiredAn array of objects representing the assessments included in the package. Each object contains the following properties:

Max length = 36
RequiredThe unique ID of the assessment.

Max length = 50
RequiredThe name of the assessment.

Max length = 250
RequiredA summary of the assessment.
assessment.tests.idGuid string

Max length = 36
RequiredID of the test

Max length = 50
RequiredName of the test

Max length = 50
RequiredCategory of the test

Max length = 250
RequiredDescription of the test

Copyright © 2024 Paylocity. All Rights Reserved. Privacy Center | Terms and Conditions | Accessibility