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

# Front OAuth 2.0 connector profile – StackOne setup guide

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

> [!WARNING]
>
> Creating an app requires access to your Front company settings.

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 an app

Front apps are created from the Developers area of your company settings. Sign in to your [Front account](https://app.frontapp.com) to begin.

**1. Open the Developers settings**

Open **Settings**, switch to the **Company** settings tab, then under **Integrations** click **Developers**.

![Front company settings with Developers highlighted under Integrations](https://mintcdn.com/stackone-60/CWAm5owApmpdxZJQ/connectors/front/images/oauth-2-0-setup-open-developers.png?fit=max\&auto=format\&n=CWAm5owApmpdxZJQ\&q=85\&s=8c2a26f2fccbc36dcb21ac79f8431394)

**2. Name the app**

On the **Developers** page, click **Create app**.

<ul>
  <li>**App name**: `StackOne Integration`</li>
  <li>**Short description**: a short note on what the app is for (for example, Integration with StackOne).</li>
  <li>Click **Save**.</li>
</ul>

![App settings tab with the App name field and Save button highlighted](https://mintcdn.com/stackone-60/CWAm5owApmpdxZJQ/connectors/front/images/oauth-2-0-setup-name-app.png?fit=max\&auto=format\&n=CWAm5owApmpdxZJQ\&q=85\&s=fc2e6ec41d3553aa1fc627dc82324fbf)

## Enable the Public API feature

Adding the **Public API** feature creates the app's OAuth client (Client ID and Client Secret).

**1. Add the Public API feature**

Click **Add feature**.

<ul>
  <li>Choose **Authorized access**.</li>
  <li>Select **Public API**.</li>
</ul>

![Features picker with the Public API card under Authorized access highlighted](https://mintcdn.com/stackone-60/CWAm5owApmpdxZJQ/connectors/front/images/oauth-2-0-setup-add-oauth-feature.png?fit=max\&auto=format\&n=CWAm5owApmpdxZJQ\&q=85\&s=8e425a8b9168af4ed60a54c0be7d4f2e)

**2. Set the redirect URL**

On the **Enable Public API** screen, under **Redirect URLs**, enter the **Callback URL** from your Connector Profile.

![Enable Public API screen with the Redirect URL field highlighted](https://mintcdn.com/stackone-60/CWAm5owApmpdxZJQ/connectors/front/images/oauth-2-0-setup-redirect-url.png?fit=max\&auto=format\&n=CWAm5owApmpdxZJQ\&q=85\&s=588e718360e82fde5c984b9c43af6e8e)

## Configure permissions and copy credentials

Select which namespaces and resources the app can access, then save and copy the credentials.

**1. Select namespace access**

Under **Namespace access**:

<ul>
  <li>Check **Global resources**.</li>
  <li>Check **Private resources**, if you need access to private resources.</li>
</ul>

![Namespace access checkboxes with Global resources and Private resources checked](https://mintcdn.com/stackone-60/CWAm5owApmpdxZJQ/connectors/front/images/oauth-2-0-setup-namespace-access.png?fit=max\&auto=format\&n=CWAm5owApmpdxZJQ\&q=85\&s=9301ab88b6f5b188d0796825b5757bb1)

**2. Configure resource permissions**

Enables actions: Add Contact Handle, Add Contact Note, Add Conversation Comment, Add Conversation Followers, Add Conversation Tag, Create Account, Create Channel, Create Child Tag, Create Contact, Create Draft, Create Inbox, Create Tag, Delete Account, Delete Contact, Delete Conversation, Delete Tag, Get Account, Get Channel, Get Contact, Get Conversation, Get Event, Get Inbox, Get Message, Get Tag, Get Teammate, Get Unified Group, Get Unified User, List Account Contacts, List Accounts, List Channels, List Child Tags, List Contact Conversations, List Contacts, List Conversation Comments, List Conversation Events, List Conversation Followers, List Conversation Messages, List Conversations, List Events, List Inbox Channels, List Inbox Conversations, List Inboxes, List Tagged Conversations, List Tags, List Teammates, List Unified Groups, List Unified Resource Users, List Unified Users, Remove Conversation Tag, Search Conversations, Send Message, Update Account, Update Channel, Update Contact, Update Conversation, Update Conversation Assignee, Update Tag, Update Teammate

Under **Resource permissions**, enable the permissions this integration needs. You can toggle a whole column using the **Read**, **Write**, **Delete**, and **Send** column headers.

<ul>
  <li>When you are done, click **Enable**.</li>
</ul>

![Resource permissions matrix with the Read, Write, Delete, and Send column headers highlighted](https://mintcdn.com/stackone-60/CWAm5owApmpdxZJQ/connectors/front/images/oauth-2-0-setup-resource-permissions.png?fit=max\&auto=format\&n=CWAm5owApmpdxZJQ\&q=85\&s=820b16bb1ed1f8465a4fde14e1a9c103)

<ul>
  <li>
    accounts:read
  </li>

  <li>
    accounts:write
  </li>

  <li>
    accounts:delete
  </li>

  <li>
    channels:read
  </li>

  <li>
    channels:write
  </li>

  <li>
    comments:read
  </li>

  <li>
    comments:write
  </li>

  <li>
    contacts:read
  </li>

  <li>
    contacts:write
  </li>

  <li>
    contacts:delete
  </li>

  <li>
    conversations:read
  </li>

  <li>
    conversations:write
  </li>

  <li>
    conversations:delete
  </li>

  <li>
    drafts:write
  </li>

  <li>
    events:\*:read
  </li>

  <li>
    inboxes:read
  </li>

  <li>
    inboxes:write
  </li>

  <li>
    messages:read
  </li>

  <li>
    messages:send
  </li>

  <li>
    tags:read
  </li>

  <li>
    tags:write
  </li>

  <li>
    tags:delete
  </li>

  <li>
    teammates:read
  </li>

  <li>
    teammates:write
  </li>

  <li>
    teams:read
  </li>
</ul>

**3. Copy the Client ID and Client Secret**

Open the app's **Public API** feature.

<ul>
  <li>Click **Copy** next to the **Client ID** field, then paste it into your Connector Profile.</li>
  <li>Click **Copy** next to the **Client secret** field, then paste it into your Connector Profile.</li>
</ul>

![Public API feature screen with the Copy button next to Client ID highlighted](https://mintcdn.com/stackone-60/CWAm5owApmpdxZJQ/connectors/front/images/oauth-2-0-setup-copy-credentials.png?fit=max\&auto=format\&n=CWAm5owApmpdxZJQ\&q=85\&s=c2342edf0798590a6094b4c5d6086d64)

## 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/front/guides/link-account/oauth-2-0.md).


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