Skip to main content

Authorization

Follow this guide to create a new 7shifts credential that will allow Nexla to authenticate to and exchange data with your 7shifts account.
seven_shifts_api_auth.png

7shifts

Prerequisites​

To connect Nexla to 7shifts, you need a 7shifts access token and your 7shifts Company ID. Both are available from the 7shifts web application. Only Admins can generate access tokens.

Generate a 7shifts Access Token​

7shifts access tokens are long-lived bearer tokens used to authenticate API requests. They are generated from the Developer Tools section of the 7shifts web application.

  1. Sign in to your 7shifts account at app.7shifts.com as an Admin.

  2. In the left navigation bar, go to Settings > Developer Tools.

  3. Click the + Create Access Token button.

  4. Enter a descriptive name for the token in the Access Token Name field (for example, Nexla Integration).

  5. Select an Admin user as the Technical Contact for this token.

  6. Click Create Access Token. Your new access token will be displayed.

Important

Copy and store your access token immediately after creation. For security reasons, you will not be able to view the full token value again after closing the dialog. If you lose the token, you will need to generate a new one.

Access tokens in 7shifts are associated with the Admin account that creates them. Only the creating Admin can view and manage the token after it is generated. For complete details, refer to the 7shifts access token documentation.

Find Your 7shifts Company ID​

The Company ID is a numeric identifier for your 7shifts company account, used to scope API requests to your specific organization.

  1. While signed in to your 7shifts account, navigate to Settings > Developer Tools.

  2. Your Company ID is displayed on the Developer Tools page alongside your access tokens.

    Alternatively, you can retrieve your Company ID by calling the 7shifts API endpoint https://api.7shifts.com/v2/companies using your access token — the response will contain your company's numeric ID.

The Company ID is required for most 7shifts API endpoints. It appears as the {company_id} path segment in API URLs (for example, https://api.7shifts.com/v2/company/{company_id}/shifts).

Create a 7shifts Credential​

  • To create a new 7shifts credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key Authentication​

7shifts uses Bearer token authentication. The access token you generated in the Prerequisites section is supplied here as the API Key credential field and will be sent in the Authorization header of every API request as Bearer {token}.

  1. Enter the access token you generated in the API Key field. This token authenticates all API requests Nexla makes to 7shifts on your behalf.

  2. Enter your numeric 7shifts Company ID in the Company ID field. This value is used as the {company_id} path parameter in API endpoint URLs and scopes all requests to your specific 7shifts organization.

To verify that your credentials are valid before saving, Nexla will make a test call to the https://api.7shifts.com/v2/whoami endpoint. A successful response confirms that the access token and company ID are correct.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.