Skip to main content

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.

1

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.

2

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.

3

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.
1

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.
2

Use Actions

Connect an AI platform to the linked account’s actions. See AI Platforms.Other ways to call actions are listed in Protocols & SDKs.

Next Steps

Webhooks setup

Configure receiving Events for 7shifts into StackOne.