7shifts is deprecating API V1 endpoint resources starting September 30, 2022 and will be End of Life (EOL) on May 31, 2023. Please the read the Migrating to V2 Endpoints Guide to understand the impact of the changes and how to migrate to supported endpoints.

We are introducing Access Tokens as a new authentication method to access our API resources. Access Tokens are replacing API keys and have the following benefits:

7shifts is deprecating API key authentication to access API resources starting August 31, 2022 and will be End of Life (EOL) on March 31, 2023. Please the read the Migrating from API Keys Guide to understand the impact of the changes and how to migrate to a supported authentication method.

The following changes were introduced in version 2022-07-13 Pre-release:

We have introduced a new version of our APIs that include numerous improvements. If you are starting a new integration or want to find out more check out our guides and API reference to get familiar with the changes. For a list of improvements and changes check out the migrating to V2 endpoints guide.

The Labor integration guides have been updated to detail when to use local or UTC date times when using different payload structures for time punches and breaks. Check out the guides Overview for more details.

We now support a state parameter during the company grant process. This can help prevent CSRF attacks or provide state information back to your application once a grant is created. Full details in the OAuth Authentication guide.

A new guide has been added for 7punches App Switching. This guide is designed for POS operators that want to use 7shifts for labor and don't want to integrate using the API. This allows the installation of 7punches into a POS and you are able to invoke the app via a URL and it will switch back to the POS application once the time punching is complete. Android support only at this time.

The user.created webhook payload has changed. The payload now includes the location, departments and role IDs the user has been assigned to. You can find more information in the user.created webhook documentation.

The following webhooks documentation was updated to include sample payloads.