Create Webhook for Candidate Screening Order

🚧

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 our team if you would like to discuss partnership opportunities.

Summary Description

Register the webhook URL for subscribing to new CandidateScreeningOrder events. Once registered, the partner’s webhook will receive real-time notifications whenever a new candidate order is placed.

Use Cases

  • Webhook Registration
    Partner provides the webhook URL for new candidate orders

  • Callback Response (below Responses section at bottom of page)
    When an order is placed for a candidate within a Paylocity module, the partner’s webhook will receive a callback URL response containing the order payload. This payload includes the details of the order and can be used by the partner to initiate their own workflows.

  • Example Use Case:
    A client places a background check order for a candidate in the Recruiting module. The partner receives the order payload through their registered webhook URL and can process the request immediately.

Body Params

The callback information

string | null

Optional. The value of the x-api-key header to utilize while executing the callback.
Allowable Values:
50 char max

callbackDetails
object

Callback Details

callerDetails
object
Headers
boolean

If true all responses are mocked and generated randomly

Responses

401

Unauthorized

Callback
Language
Credentials
Header
LoadingLoading…
Choose an example:
application/json