> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 7shifts

> How to set up the 7shifts connector, plus the actions and events that are available.

![7shifts](https://stackone-logos.com/api/7shifts/filled/svg)

v1.5.1[See changelog](https://docs.stackone.com/connectors/7shifts/changelog.md)

[59 actions](#actions) · [18 events](#events) · 2 auth methods

HRIS

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [Access Token · Connector Profile](https://docs.stackone.com/connectors/7shifts/guides/connector-profile/access-token.md)
>
> Uses a long-lived Bearer token generated in Company Settings. Token inherits the permissions of the admin who created it...

> [card] [OAuth 2.0 (Client Credentials) · Connector Profile](https://docs.stackone.com/connectors/7shifts/guides/connector-profile/oauth-2-0-client-credentials.md)
>
> For vetted 7shifts partners. One OAuth client serves every customer company that grants it access, so each connected acc...

Optionally, configure receiving Events for 7shifts into StackOne.

> [card] [Webhooks setup](https://docs.stackone.com/connectors/7shifts/guides/webhook-setup.md)

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [Access Token · Link Account](https://docs.stackone.com/connectors/7shifts/guides/link-account/access-token.md)

> [card] [OAuth 2.0 (Client Credentials) · Link Account](https://docs.stackone.com/connectors/7shifts/guides/link-account/oauth-2-0-client-credentials.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Access Token

OAuth 2.0 (Client Credentials)

No auth methods found

Scopes

Select all
|
Clear

companies:read

companies:write

departments:read

departments:write

events:read

events:write

locations:read

locations:write

roles:read

roles:write

shifts:read

shifts:write

time\_punches:read

time\_punches:write

users:read

users:write

No scopes found

59 actions

ActionDescriptionRequired scopes

List Companies`7shifts_list_companies`

List all companies accessible to the authenticated user

`companies:read`

Get Company`7shifts_get_company`

Retrieve details for a specific company

`companies:read`

Update Company`7shifts_update_company`

Update a company's details

`companies:write`

Get Labor Settings`7shifts_get_labor_settings`

Retrieve labor settings for a company

`companies:read`

List Inactive Reasons`7shifts_list_inactive_reasons`

List inactive reasons for a company

`companies:read`

List Locations`7shifts_list_locations`

List all locations for a company

`locations:read`

Get Location`7shifts_get_location`

Retrieve a specific location by ID

`locations:read`

Create Location`7shifts_create_location`

Create a new location for a company

`locations:write`

Update Location`7shifts_update_location`

Update an existing location

`locations:write`

Delete Location`7shifts_delete_location`

Delete a location from a company

`locations:write`

List Departments`7shifts_list_departments`

List all departments for a company

`departments:read`

Get Department`7shifts_get_department`

Retrieve a specific department by ID

`departments:read`

Create Department`7shifts_create_department`

Create a new department

`departments:write`

Update Department`7shifts_update_department`

Update an existing department

`departments:write`

Delete Department`7shifts_delete_department`

Delete a department

`departments:write`

List Roles`7shifts_list_roles`

List all roles for a company

`roles:read`

Get Role`7shifts_get_role`

Retrieve a specific role by ID

`roles:read`

Create Role`7shifts_create_role`

Create a new role

`roles:write`

Update Role`7shifts_update_role`

Update an existing role

`roles:write`

Delete Role`7shifts_delete_role`

Delete a role

`roles:write`

List Users`7shifts_list_users`

List all users for a company

`users:read`

Get User`7shifts_get_user`

Retrieve a user's full profile by ID

`users:read`

Create User`7shifts_create_user`

Create a new user in a company

`users:write`

Update User`7shifts_update_user`

Update an existing user

`users:write`

Delete User`7shifts_delete_user`

Deactivate a user from a company

`users:write`

Get User Assignments`7shifts_get_user_assignments`

Get location, department, and role assignments for a user

`users:read`

Create User Wage`7shifts_create_user_wage`

Create a wage record for a user

`users:write`

List User Contacts`7shifts_list_user_contacts`

List user contacts for a company

`users:read`

Get User Contact`7shifts_get_user_contact`

Retrieve a user's phone and email contact info

`users:read`

List User Authorized Locations`7shifts_list_user_authorized_locations`

List authorized locations for a user

`users:read`

List Shifts`7shifts_list_shifts`

List all shifts for a company

`shifts:read`

Get Shift`7shifts_get_shift`

Retrieve a specific shift by ID

`shifts:read`

Create Shift`7shifts_create_shift`

Create a new shift

`shifts:write`

Update Shift`7shifts_update_shift`

Update an existing shift

`shifts:write`

Delete Shift`7shifts_delete_shift`

Delete a shift

`shifts:write`

List Time Punches`7shifts_list_time_punches`

List all time punches for a company

`time_punches:read`

Get Time Punch`7shifts_get_time_punch`

Retrieve a specific time punch by ID

`time_punches:read`

Create Time Punch`7shifts_create_time_punch`

Create a new time punch

`time_punches:write`

Update Time Punch`7shifts_update_time_punch`

Update an existing time punch

`time_punches:write`

Delete Time Punch`7shifts_delete_time_punch`

Delete a time punch

`time_punches:write`

List Time Off`7shifts_list_time_off`

List time off requests

Get Time Off`7shifts_get_time_off`

Retrieve a specific time off request by ID

Create Time Off`7shifts_create_time_off`

Create a new time off request

Update Time Off`7shifts_update_time_off`

Update a time off request

Delete Time Off`7shifts_delete_time_off`

Delete a time off request

Approve Time Off`7shifts_approve_time_off`

Approve a time off request

Decline Time Off`7shifts_decline_time_off`

Decline a time off request

Get Time Off Total Hours`7shifts_get_time_off_total_hours`

Retrieve total time off hours for employees

Get Time Off Settings`7shifts_get_time_off_settings`

Retrieve time off settings for a company

Create Time Off Settings`7shifts_create_time_off_settings`

Create or update time off settings for a company

List Events`7shifts_list_events`

List events for a company

`events:read`

Create Event`7shifts_create_event`

Create a new event

`events:write`

Get Event`7shifts_get_event`

Retrieve a specific event by ID

`events:read`

Update Event`7shifts_update_event`

Update an existing event

`events:write`

Delete Event`7shifts_delete_event`

Delete an event

`events:write`

Get Hours And Wages Report`7shifts_get_hours_and_wages_report`

Retrieve worked hours and wages report

Get Daily Sales And Labor Report`7shifts_get_daily_sales_and_labor_report`

Retrieve daily sales and labor report

Get Daily Stats`7shifts_get_daily_stats`

Retrieve daily stats for a location

Get Current User`7shifts_get_whoami`

Retrieve the identity of the authenticated user

## Events

Tags

Select all
|
Clear

Departments

Locations

Reports

Roles

Shifts

Time Punches

Users

Webhooks

No tags found

18 events

EventDescriptionTags

User Created Webhook`7shifts_webhook_user_created`

Processes 7shifts user.created webhook events.

UsersWebhooks

User Modified Webhook`7shifts_webhook_user_modified`

Processes 7shifts user.modified webhook events.

UsersWebhooks

User Deactivated Webhook`7shifts_webhook_user_deactivated`

Processes 7shifts user.deactivated webhook events.

UsersWebhooks

User Reactivated Webhook`7shifts_webhook_user_reactivated`

Processes 7shifts user.reactivated webhook events.

UsersWebhooks

Time Punch Created Webhook`7shifts_webhook_time_punch_created`

Processes 7shifts time\_punch.created webhook events.

Time PunchesWebhooks

Time Punch Edited Webhook`7shifts_webhook_time_punch_edited`

Processes 7shifts time\_punch.edited webhook events.

Time PunchesWebhooks

Time Punch Deleted Webhook`7shifts_webhook_time_punch_deleted`

Processes 7shifts time\_punch.deleted webhook events.

Time PunchesWebhooks

Schedule Published Webhook`7shifts_webhook_schedule_published`

Processes 7shifts schedule.published webhook events.

ShiftsWebhooks

Payroll Period Closed Webhook`7shifts_webhook_payroll_period_closed`

Processes 7shifts payroll\_period.closed webhook events.

ReportsWebhooks

Department Created Webhook`7shifts_webhook_department_created`

Processes 7shifts department.created webhook events.

DepartmentsWebhooks

Department Modified Webhook`7shifts_webhook_department_modified`

Processes 7shifts department.modified webhook events.

DepartmentsWebhooks

Department Deleted Webhook`7shifts_webhook_department_deleted`

Processes 7shifts department.deleted webhook events.

DepartmentsWebhooks

Location Created Webhook`7shifts_webhook_location_created`

Processes 7shifts location.created webhook events.

LocationsWebhooks

Location Modified Webhook`7shifts_webhook_location_modified`

Processes 7shifts location.modified webhook events.

LocationsWebhooks

Location Deleted Webhook`7shifts_webhook_location_deleted`

Processes 7shifts location.deleted webhook events.

LocationsWebhooks

Role Created Webhook`7shifts_webhook_role_created`

Processes 7shifts role.created webhook events.

RolesWebhooks

Role Modified Webhook`7shifts_webhook_role_modified`

Processes 7shifts role.modified webhook events.

RolesWebhooks

Role Deleted Webhook`7shifts_webhook_role_deleted`

Processes 7shifts role.deleted webhook events.

RolesWebhooks


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.