> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Clover OAuth 2.0 (PKCE) connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 (PKCE) for Clover in StackOne to allow users to link their accounts.

> [!WARNING]
>
> A Clover developer account is required. You must be able to create apps in the Clover Developer Dashboard.

Select Actions to adjust the guideSome actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.

Select all
Clear

ActionScope(s)

Loading actions...No actions match your search.

Dynamic Guide URL

Copy URL

Scopes Selected

<pre role="textbox" aria-readonly="true" tabIndex="0" />

Separator

Copy scopes

## Create a Clover developer account

A Clover developer account provides access to the Developer Dashboard where you create and manage apps.

**1. Sign up for a developer account**

Go to the [Clover Global Developer Dashboard](https://www.clover.com/global-developer-home/public/create-account) and create an account.

<ul>
  <li>Enter your email address and click **Create Account**.</li>
  <li>Check your email and click **Set a password** in the confirmation message.</li>
  <li>Enter your name and a **Public Developer Name** (displayed in the Clover App Market).</li>
  <li>Fill in the test merchant details (name, country, address, currency, timezone) and click **Create Account**.</li>
  <li>Note: Clover creates a default test merchant for both sandbox and production environments.</li>
</ul>

## Create and configure an app

Register a new app in the Developer Dashboard to obtain your App ID.

**1. Sign in to the Developer Dashboard**

Sign in to the [Clover Developer Dashboard](https://www.clover.com/global-developer-home).

<ul>
  <li>Toggle to your desired environment (Sandbox or Production).</li>
  <li>Click **Create new app**.</li>
</ul>

**2. Fill in app details**

Complete the app creation form.

<ul>
  <li>App Name: `StackOne Integrations`</li>
  <li>Select the target country for your merchants.</li>
  <li>App Type: select **Web** in the Web app section.</li>
  <li>Click **Create App**.</li>
</ul>

**3. Copy your App ID**

After creation, the **App Settings** page displays your credentials.

<ul>
  <li>Navigate to **Your Apps** > **App name** > **App Settings**.</li>
  <li>Copy the **App ID**. The App Secret is not needed for this authentication method.</li>
</ul>

**4. Configure REST settings**

Set the redirect URI so Clover can redirect merchants back to StackOne after authorization.

<ul>
  <li>In **App Settings**, click **REST Configuration**.</li>
  <li>Site URL: the **Callback URL** from your Connector Profile</li>
  <li>Default OAuth Response: select **Code**.</li>
  <li>Click **Save**.</li>
</ul>

## Configure app permissions

Select the permissions your app needs to access Clover merchant data.

**1. Set requested permissions**

Enables actions: Create A Customer, Create A Discount, Create A Discount On An Order, Create A New Line Item, Create A Phone Number For A Customer, Create A Tax Rate For A Merchant, Create An Address For A Customer, Create An Email Address For A Customer, Create An Employee, Create An Inventory Item, Create An Item Category, Create Custom Orders, Create Shift For An Employee, Delete A Customer, Delete A Single Item Category, Delete A Single Shift, Delete An Employee, Delete An Inventory Item, Delete An Order, Delete An Order Discount, Get A Category, Get A List Of Customers, Get A Merchant's Address, Get A Merchant's Properties, Get A Single Customer, Get A Single Discount, Get A Single Employee, Get A Single Inventory Item, Get A Single Merchant, Get A Single Order, Get A Single Payment, Get A Single Refund, Get A Single Tax Rate, Get All Cash Events, Get All Categories, Get All Devices Provisioned To A Merchant, Get All Discounts, Get All Employees, Get All Inventory Items, Get All Line Items For An Order, Get All Modifiers, Get All Order Types For A Merchant, Get All Payments, Get All Payments For An Order, Get All Refunds For A Merchant, Get All Roles For A Merchant, Get All Shifts For An Employee, Get All Tags, Get All Tax Rates, Get All Tenders For A Merchant, Gets A List Of Orders, Update A Category, Update A Customer, Update A Line Item, Update A Phone Number For A Customer, Update A Single Shift, Update An Address For A Customer, Update An Email Address For A Customer, Update An Employee, Update An Existing Inventory Item, Update An Order, Update Merchant Properties, Update The Stock Of An Inventory Item, Void A Line Item

In **App Settings**, click **Requested Permissions**. Select the required Read or Write permissions for each category.

<ul>
  <li>
    MERCHANT\_R
  </li>

  <li>
    MERCHANT\_W
  </li>

  <li>
    ORDERS\_R
  </li>

  <li>
    ORDERS\_W
  </li>

  <li>
    INVENTORY\_R
  </li>

  <li>
    INVENTORY\_W
  </li>

  <li>
    CUSTOMERS\_R
  </li>

  <li>
    CUSTOMERS\_W
  </li>

  <li>
    EMPLOYEES\_R
  </li>

  <li>
    EMPLOYEES\_W
  </li>

  <li>
    PAYMENTS\_R
  </li>

  <li>
    PAYMENTS\_W
  </li>
</ul>

**2. Save permissions**

Provide a brief justification for each selected permission describing how the integration uses the data, then click **Save**.

<ul>
  <li>Note: If merchants have already installed the app, permission changes only take effect after they uninstall and reinstall it.</li>
</ul>

## Create the StackOne Connector Profile

**1. Create a Connector Profile**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

**2. Link an Account**

Once the Connector Profile is created, continue to [link an account](https://docs.stackone.com/connectors/clover/guides/link-account/oauth-2-0-pkce.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.