API Reference
Back to 7shifts.comBecome a Partner

Create Shift

post
https://api.7shifts.com/v2/company//shifts
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int64
required

Company ID

Body Params
integer
required

Shift ID

integer

User ID

integer | null

Department ID. Required if the location uses departments.

integer | null

Role ID. Required if the location uses roles.

integer | null

Station Number

date-time
required

Start date time of the shift. UTC in ISO8601 format.

date-time
required

End date time of the shift. UTC in ISO8601 format.

boolean | null

Set to true if the shift ends at closing time. If set, end is not used.

boolean | null

Set to true if the shift ends at business decline.

string | null

Notes displayed on a shift.

boolean | null

If true the shift is not published.

boolean | null

If true the user has been notified of the published shift.

boolean | null

Set to true if the shift is not assigned to any user. Open shifts can be requested by users.

integer | null

Set when open is true. Set to 1 for everyone can request an open shift; set to 1 if only offered to specified role.

boolean | null

Set to true if the shift should be made available to the 7shifts job network.

number | null

The wage to offer the shift at in the 7shifts job network.

boolean | null

Internal use only

integer | null
enum

The skill level required for this shift.

Allowed:
integer | null
enum

Shift status type. 0 - none, 1 - sick, 2 - no show, 3 - late, 4 - call out, 5 - left late.

Allowed:
integer | null

Number of minutes a user can clock in late after the shift starts.

breaks
array of objects or null | null

Breaks to be created with the shift

breaks
Headers
string

7shifts API version

uuid

Company GUID

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated 11 months ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
application/problem+json

Updated 11 months ago