# Staffology Payroll private preview

HollyHR's Staffology connection is a **read-only private preview**, not a
generally available payroll sync or a payroll engine. Confirm preview access
with HollyHR before relying on it. Provider qualification and repair work are
separate from documenting the implemented connection.

## Scope

The connector binds one Staffology employer to the selected HollyHR
organisation. It discovers accessible employers, looks up an employee by exact
payroll code and records an explicitly reviewed match in HollyHR. It does not
create Staffology employees, change payroll data or create payroll runs.

The bounded provider client uses these read routes:

- `GET /employers`
- `GET /employers/{employerId}/employees/search/payrollcode?code={payrollCode}`

This is a first-party HollyHR connection, not a public API or MCP operation.
Its Staffology key is not a HollyHR API key and must not be supplied to Zapier,
Make or an AI chat.

## Preview setup

1. An authorised HollyHR administrator opens **Integrations → Connected apps →
   Staffology Payroll** in the intended organisation.
2. Enter a Staffology key for a demo or customer-authorised employer directly
   in the protected setup form. Use **Find accessible employers**.
3. Select the intended employer and choose **Connect selected employer**.
   Complete sensitive-action verification when requested.
4. Select a HollyHR person and enter their exact Staffology payroll code.
   Review the returned name and identifier before saving or replacing a match.
5. Check matching health before depending on the links. A successful connection
   alone does not prove that every employee has a valid match.

The preview limits active mappings to 25 per connection. Remapping an existing
person does not increase that count. This is a preview limit, not a promise of
general-release capacity.

## Credentials and recovery

Use only a key whose owner has authorised access to the selected employer. Do
not paste it into logs, support messages or documentation. Employer discovery
must succeed before the connection is confirmed; an empty or failed discovery
must not be treated as a connected employer.

Replacing a key retains the employer selection. Verify its employer access and
existing matches after replacement. If discovery or matching fails, retain your
current payroll process and contact HollyHR with a content-minimised error
description, not the key or employee response.

**Disconnect and erase credential** removes HollyHR's encrypted credential
copy. Revoke the original key in Staffology as well when it is no longer needed;
removing HollyHR's copy does not revoke the provider-issued key.

For availability and preview enquiries, use the
[Staffology overview](https://www.hollyhr.com/integrations/staffology).