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

# Scoro OAuth 2.0 connector profile – StackOne setup guide

> Set up a connector profile using OAuth 2.0 for Scoro in StackOne to allow users to link their accounts.

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

## Registering an OAuth app

Register a private app in the Scoro Developer Portal. A private app works only on the Scoro sites listed in its **Site URLs**, up to 3.

**1. Create the app**

Sign in to the [Scoro Developer Portal](https://developers.scoro.com), then click **Create app**.

<ul>
  <li>Name the app `StackOne Integration`.</li>
  <li>**App type**: **Private**</li>
  <li>**Authentication type**: **OAuth**. It can't be changed after the first save.</li>
</ul>

**2. Set the callback and site URLs**

Both lists are on the **Setup** tab.

<ul>
  <li>**Callback URLs**: the **Callback URL** from your Connector Profile</li>
  <li>**Site URLs**: the address of each Scoro site that will connect</li>
  <li>Format: `https://{site}.scoro.com`</li>
  <li>Example: `https://acme.scoro.com`</li>
  <li>To connect any customer's site, switch the app to **Public** and complete **App Store profile** and **Submit for review**. Once Scoro publishes it, any site can connect.</li>
</ul>

**3. Set the access**

Enables actions: Create Activity Type, Create Bill, Create Calendar Event, Create Company, Create Expense, Create Invoice, Create Invoice Payment, Create Order, Create Person, Create Product, Create Project, Create Project Phase, Create Quote, Create Status, Create Tag, Create Task, Create Task Comment, Create Tax Rate, Create Time Entry, Delete Calendar Event, Delete Company, Delete Invoice, Delete Order, Delete Person, Delete Project, Delete Quote, Delete Task, Delete Time Entry, Get Bill, Get Calendar Event, Get Company, Get Current User, Get Expense, Get Invoice, Get Order, Get Person, Get Project, Get Quote, Get Task, Get Time Entry, Get User, List Activity Types, List Bills, List Calendar Events, List Companies, List Custom Fields, List Expenses, List Invoice Lines, List Invoice Payments, List Invoices, List Order Lines, List Orders, List Payment Accounts, List Persons, List Products, List Project Phases, List Projects, List Quote Lines, List Quotes, List Statuses, List Tags, List Task Comments, List Task Time Entries, List Tasks, List Tax Rates, List Time Entries, List Users, Search Companies, Search Persons, Search Projects, Search Tasks, Update Calendar Event, Update Company, Update Invoice, Update Order, Update Person, Update Project, Update Quote, Update Task, Update Time Entry

Set each resource to its level in the scope list: `:r` is **View**, `:rw` is **Edit** and `:rwd` is **Full**.

<ul>
  <li>Click **Manage access**.</li>
  <li>Expand a group to set the level of one resource in it.</li>
  <li>Leave every other group **Off**. **Basic information** is always on.</li>
  <li>Click **Save**.</li>
</ul>

<ul>
  <li>
    base:r
  </li>

  <li>
    users:r
  </li>

  <li>
    contacts:r
  </li>

  <li>
    contacts:rw
  </li>

  <li>
    contacts:rwd
  </li>

  <li>
    projects:r
  </li>

  <li>
    projects:rw
  </li>

  <li>
    projects:rwd
  </li>

  <li>
    tasks:r
  </li>

  <li>
    tasks:rw
  </li>

  <li>
    tasks:rwd
  </li>

  <li>
    calendar:r
  </li>

  <li>
    calendar:rw
  </li>

  <li>
    calendar:rwd
  </li>

  <li>
    quotes:r
  </li>

  <li>
    quotes:rw
  </li>

  <li>
    quotes:rwd
  </li>

  <li>
    orders:r
  </li>

  <li>
    orders:rw
  </li>

  <li>
    orders:rwd
  </li>

  <li>
    invoices:r
  </li>

  <li>
    invoices:rw
  </li>

  <li>
    invoices:rwd
  </li>

  <li>
    invoice-payments:r
  </li>

  <li>
    invoice-payments:rw
  </li>

  <li>
    payment-accounts:r
  </li>

  <li>
    bills:r
  </li>

  <li>
    bills:rw
  </li>

  <li>
    expenses:r
  </li>

  <li>
    expenses:rw
  </li>

  <li>
    products:r
  </li>

  <li>
    products:rw
  </li>

  <li>
    activity-types:r
  </li>

  <li>
    activity-types:rw
  </li>

  <li>
    statuses:rw
  </li>

  <li>
    tags:rw
  </li>

  <li>
    tax-rates:rw
  </li>
</ul>

**4. Copy the credentials**

After the save, the app's **OAuth credentials** card is on the **Setup** tab.

<ul>
  <li>Click **Generate OAuth credentials**.</li>
  <li>Copy the **Client Secret** into your Connector Profile. Scoro shows it only once, in a dialog, and it cannot be retrieved later.</li>
  <li>Copy the **OAuth Client ID** into your Connector Profile.</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/scoro/guides/link-account/oauth-2-0.md).


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