Upserts screening package

post https://dc1demogwext.paylocity.com/compliance/v1/companies/{companyId}/backgroundCheck/screeningPackages/{packageId}

🚧
Partner Restricted
All background check API endpoints are restricted to background check providers that have signed a Paylocity technology partnership agreement. Please reach out to Techpartnerships@paylocity.com if you would like to discuss partnership opportunities.

Summary Description

Upserts information about screening packages for the companyId

Use Cases

Partner wants to send over a screening package for a client, can be when onboarding a new client, or can be when client adds a new package to their company
Partner wants to make a specific screening package either active or inactive for a client
Partner wants to update the price of a client’s screening package
Partner wants to add services to a package
Partner wants to add a billing code to correlate to a specific BGC package

Path Params

companyId

string

required

The Paylocity Company Identifier. This is the unique value provided by Paylocity to each specific Payroll Entity.
Allowable Values:
9 char max

packageId

string

required

The Id of the Screening Package.
Allowable Values:
36 char max

Body Params

The Package data

isActive

boolean

A Boolean value indicating if the package is active.
Allowable Values:
true, false

packageSummary

string | null

A detailed description of the background check package and what is included in the package.
Allowable Values:
250 char max

packageName

string | null

The name of the specific background check package that the users will see.
Allowable Values:
250 char max

services

array of objects | null

An array of objects representing the underlying services that are included in the background check package.

services

price

object

An object representing the price of the package.

billingCode

string | null

Billing code created by a client that can be associated with an order (optional).

Headers

testMode

boolean

If true all responses are mocked and generated randomly

Authorization

string

required

Authorization token. Ex. Bearer ...

Responses

400

Bad Request Error - Returns the details of the error

401

Unauthorized

Language

Credentials

Header


xxxxxxxxxx
1
curl --request POST \
2
     --url https://dc1demogwext.paylocity.com/compliance/v1/companies/companyId/backgroundCheck/screeningPackages/packageId \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json'


xxxxxxxxxx
 
1
{
2
  "upsertResult": {
3
    "inserted": true,
4
    "updated": true
5
  }
6
}

200Returns the details of the upsert operation

415Unsupported Media Type - Returns the details of the error