Changelog2025

New List Employees Endpoint

We added the following public API endpoint for retrieving employee data:

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 fields query parameter.
  • Supports both Basic Auth and OAuth 2.0 with the employees.read, employees:name.read, and employees:job.read scopes.

The existing directory endpoint and custom reports are unchanged, so no action is required for current integrations.