Have the customer grant your client access
A company administrator on the customer’s account must authorize your OAuth client before you can call the API on their behalf.
Generate the grant link for the customer administrator
Send them to https://app.7shifts.com/generate_token?client_id={CLIENT_ID}, using the Client ID from this connector profile. Surfacing this link on your own Integrations or Marketplace page is the usual approach.
Review what the administrator sees
They sign in to 7shifts, choose which company to grant access to if they administer several, review your company name and logo, and approve.
Copy the company GUID
On approval 7shifts creates a grant GUID. With a redirect URL configured on your client, the administrator is redirected to it with guid and company_id attached. Without one, they see a page showing the GUID and send it to you.
- An administrator can also retrieve it later under Company settings > Developer Tools > Connected Apps, via “Copy the GUID to the clipboard”.
Fill in this account
Both values identify the single customer company this account reads and writes.
- Company GUID — from the grant, sent on every request as
x-company-guid. - Company ID — the numeric company id, used in endpoint paths.
Link the Account
Connect
- Click Connect.
- If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
- Once authorization is successful, you will see a confirmation popup.
Use Actions
Next Steps
Webhooks setup
Configure receiving Events for 7shifts into StackOne.