Get Changed Employee IDs
Changed onReturns a list of employee IDs that have changed since the given timestamp. This allows for efficient syncing of employee data — rather than downloading all employees, only those that have changed are returned. A change in ANY individual field in the employee record, as well as any change to the employment status, job info, or compensation tables, will cause that employee to be returned. Each entry includes the employee ID, the type of change (Inserted, Updated, or Deleted), and the last-changed timestamp.
OAuth Scopes: public.integration, public.user
Request
- Base URLhttps://companySubDomain.bamboohr.com
- Auth
- HTTP basic
- or OAuth 2Authorization code/authorize.phpToken URL/token.phpScopespublic.user
- or OAuth 2Authorization code/authorize.phpToken URL/token.phpScopespublic.integration
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Query parameters
ISO 8601 timestamp (URL-encoded). Only employees changed since this timestamp will be returned.
Filter by change type. If omitted, all change types are returned.
Response
The latest change timestamp in the result set and a map of employees changed since the given timestamp.
Changes
- info
the security scope
public.userwas added to the endpoint's security schemeoauth - info
the security scope
public.integrationwas removed from the endpoint's security schemeoauth
- info