# PayFit + Lutril: setup guide

> Lutril connects to PayFit with a Partner API key to read your employee directory (collaborators and their job titles). You generate the key in PayFit's integrations hub; Lutril resolves your company automatically.

Source: https://www.lutril.com/integrations/payfit
Category: Identity (IDP)
Auth: api_key
Last verified: 2026-06-17

---

## Setup

1. [object Object]
2. Click Create a key, give it an explicit label, and grant the collaborators:read and collaborators:contracts:read scopes (both are required; collaborators:contracts:read is needed to read job titles).
3. Copy the key immediately; PayFit shows it only once.
4. In Lutril, connect PayFit and paste the API key. Your company is detected automatically from the key.

## Access requested

- collaborators:read (read general collaborator information)
- collaborators:contracts:read (read job titles)

## References

- [PayFit documentation](https://developers.payfit.io/docs/authentication-via-api-key)
- [PayFit console](https://app.payfit.com/integrations/hub/api)
- [Scopes for partners](https://developers.payfit.io/docs/scopes-for-partners)
- [Start with the PayFit API](https://developers.payfit.io/docs/start-with-payfit-api)