Changelog2025
New List Employees Endpoint
We added the following public API endpoint for retrieving employee data:
- List Employees (
GET /api/v1/employees)
It offers a more flexible way to retrieve employees than the directory endpoint or a custom report, letting you request only the employees and fields you need.
Key details:
- Filter by fields such as first name, last name, job title, status, or employee IDs.
- Sort by supported employee fields.
- Cursor-based pagination for large result sets.
- Select specific fields with the
fieldsquery parameter. - Supports both Basic Auth and OAuth 2.0 with the
employees.read,employees:name.read, andemployees:job.readscopes.
The existing directory endpoint and custom reports are unchanged, so no action is required for current integrations.