/
7S
7shifts
/
7shifts API
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 2w ago · Updated 2w ago
View markdown
7shifts
7shifts API
post
Create Time Off
v1
latest
OpenAPI 3.0.2
2026-07-24
154
10
1.1 MB
Account
1
Authentication
2
Availability
10
Companies
5
Day Part
1
Departments
5
Employment Record
5
Engage
2
External User Mappings
12
Forecast Overrides
4
Locations
5
Log Book
12
Receipts
5
Reports
6
Roles
5
Schedule Enforcement
1
Schedule Events
5
Shifts
5
Task Management
13
Time Clocking
2
Time Off
10
get
List Time Off
post
Create Time Off
get
Retrieve Time Off
delete
Delete Time Off
patch
Update Time Off
post
Approve Time Off Request
post
Decline Time Off Request
get
Retrieve Time Off Hours
get
Retrieve Time Off Settings
post
Create Time Off Settings
Time Punches
5
Tip Pool
5
User Assignments
12
User Wages
2
Users
9
Webhooks
5
Time Off
Create Time Off
post
/v2/time_off
Request body
object
required
user_id
integer
required
company_id
integer
required
from_date
string
required
to_date
string
required
partial
boolean
required
partial_from
string
time
nullable
partial_to
string
time
nullable
comments
string
status
integer
required
category
string
required
hours
object[]
status_action_user_id
integer
nullable
status_action_message
string
Response
The newly created time off
object
required
id
integer
required
user_id
integer
required
company_id
integer
required
from_date
string
required
to_date
string
required
partial
boolean
required
partial_from
string
time
nullable
required
partial_to
string
time
nullable
required
comments
string
required
status
integer
required
status_action_user_id
integer
nullable
required
status_action_message
string
required
category
string
required
created
string
required
amount_of_hours
number
required
hours
object[]
required