# 7shifts API Documentation

This is the complete API documentation for connecting to the 7shifts API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **7shifts connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/shifts/actions/{actionSlug}/run
```

## 7shifts actions

- POST `create-department` Create Department
- POST `create-employment-record` Create Employment Record
- POST `create-location` Create Location
- POST `create-role` Create Role
- POST `create-role-assignment` Create Role Assignment
- POST `create-shift` Create Shift
- POST `create-time-punch` Create Time Punch
- POST `create-user` Create User
- POST `create-user-wage` Create User Wage
- DELETE `deactivate-user` Deactivate User
- DELETE `delete-shift` Delete Shift
- GET `get-user-contacts` Get User Contacts
- GET `list-assignments` List Assignments
- GET `list-companies` List Companies
- GET `list-departments` List Departments
- GET `list-employment-records` List Employment Records
- GET `list-locations` List Locations
- GET `list-role-assignments` List Role Assignments
- GET `list-roles` List Roles
- GET `list-shifts` List Shifts
- GET `list-time-punches` List Time Punches
- GET `list-user-wages` List User Wages
- GET `list-users` List Users
- GET `list-users-authorized-locations` List Users Authorized Locations
- GET `retrieve-company` Retrieve Company
- GET `retrieve-department` Retrieve Department
- GET `retrieve-identity` Retrieve Identity
- GET `retrieve-labor-settings` Retrieve Labor Settings
- GET `retrieve-location` Retrieve Location
- GET `retrieve-role` Retrieve Role
- GET `retrieve-shift` Retrieve Shift
- GET `retrieve-time-punch` Retrieve Time Punch
- GET `retrieve-user` Retrieve User
- GET `retrieve-user-contact` Retrieve User Contact
- PUT `update-department` Update Department
- PUT `update-location` Update Location
- PUT `update-role` Update Role
- PUT `update-shift` Update Shift
- PUT `update-time-punch` Update Time Punch
- PUT `update-user` Update User