When I Work Import API
The import API is used to import a variety of When I Work resources from user-provided CSV or Excel files.### Import TypesAll available import types and their columns are listed here. Where possible, the column names will align with names used elsewhere in the API, but this is not always possible. type columns required? notes SHIFT_TEMPLATE start_time ✅ end_time ✅ schedule A schedule name to associate with the shift template. If no schedule with that name exists,a new schedule will be created. If omitted, the shift template will be assigned to all schedules (or the value "All Schedules"can be provided to do the same). position A position name to associate with the shift template. If no position with that name exists,a new position will be created. unpaid_break The length of the unpaid break in minutes. EMPLOYEE first_name ✅ First name of the employee last_name ✅ Last name of the employee email The email address of the employee employee_code The employee code to associate with the employee file_number The file number corresponding to the employee in ADP id The user id corresponding to the employee in When I Work location A schedule (location) name to associate with the employee. If no schedule with that nameexists, a new schedule will be created. max The maximum hours per week of the employee phone The phone number of the employee position A position name to associate with the employee. If no position with that name exists,a new position will be created. tags A comma separated list of tags to associate to the employee. If the tag does not exist,it will be created. wage The hourly rate of the employee expressed as a floating point number (e.g. 14.50)
When I Work Import API is one of 22 APIs that When I Work publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 8 JSON Schema definitions.
Tagged areas include Import. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, and 8 JSON Schemas.
This API exposes 4 operations across 4 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.
Requests are made against a single base URL, https://api.wheniwork.com.
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
When I Work Import API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (JSON Web Token) (W-Token).
By default, every request must be authenticated.
W-Token— Authentication with When I Work is based on a token model using [JSON Web Tokens](https://jwt.io/). First, you authenticate using a private developer key and t…
Paths & Operations 4
Across 4 paths, the API surfaces 4 operations — 1 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.
The import API is used to import a variety of When I Work resources from user-provided CSV or Excel files. Import Types All available import types and their columns are listed her…
Schemas 4
The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Import (4 properties), EmployeeExtra (1 property). Each schema is shown below with its type and property counts.
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from When I Work 12
Other APIs When I Work publishes across the network.