En API Keys, crea la clave y marca los scopes (employees, payroll, departments, positions, timeclock, reports). Se muestra una sola vez.
Crear la clave
En el menú API Keys, haz clic en "Nueva API Key", ponle un nombre que identifique la integración (el ERP, el reloj de asistencia, el BI) y marca los scopes. Los scopes disponibles son employees:read, employees:write, payroll:read, payroll:write, departments:read, departments:write, positions:read, positions:write, timeclock:read, timeclock:write y reports:read.
La clave se muestra una sola vez, al crearla. Cópiala en una bóveda de secretos; si la pierdes, revócala y crea otra.
Una clave, una empresa
Cada clave pertenece a una empresa y solo ve sus datos. Para integrar varias empresas de la misma cuenta, crea una clave en cada una. GET /companies devuelve la empresa de la clave, lo que ayuda al integrador a confirmar dónde está escribiendo.
Buenas prácticas
Usa una clave por integración y solo los scopes que necesita: un BI que lee informes recibe reports:read y nada más. Revoca la clave de inmediato si se filtra; la revocación surte efecto al instante. Cada creación y revocación queda en la auditoría, y las llamadas hechas con la clave se registran durante 90 días.