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

# Lumin OAuth 2.0 connector profile – StackOne setup guide

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

> [!WARNING]
>
> Only the Owner of a Lumin Workspace can create integration apps.

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

A private integration app lets StackOne connect to Lumin with OAuth 2.0 and refresh access tokens.

**1. Start the app**

Sign in to [Lumin](https://www.luminpdf.com/app/pdf), then click **Settings** > **Developer settings**.

<ul>
  <li>Click the **Integration apps** tab.</li>
  <li>Click **Create app**.</li>
</ul>

![The Integration apps tab with the Create app button highlighted](https://mintcdn.com/stackone-60/J806qduiWbw3dQTz/connectors/lumin/images/oauth2-setup-create-app.png?fit=max\&auto=format\&n=J806qduiWbw3dQTz\&q=85\&s=aed2cd81c941c8667c1996fe9c8bd27c)

**2. Enter the basic information**

Under **Basic information**, fill in the app details.

<ul>
  <li>**Application name**: `StackOne Integration`</li>
  <li>**Application type**: **Private (Server) application**</li>
</ul>

![The Basic information section with the Application name field and the Private (Server) application option highlighted](https://mintcdn.com/stackone-60/J806qduiWbw3dQTz/connectors/lumin/images/oauth2-setup-basic-information.png?fit=max\&auto=format\&n=J806qduiWbw3dQTz\&q=85\&s=2032e480b114def53a887095441a1691)

**3. Add the scopes**

Enables actions: Add Password, Cancel Signature Request, Compress Document, Create Agreement, Create Document, Create Signing Session, Create Space, Generate Document From Template, Get Agreement File, Get Signature Request, Get Signature Request File, Get Signing Link, Get Template Details, Get User Information, Get Workspace Information, Get Workspace Members, List Spaces, List Templates, Merge Documents, Remove Password, Send Reminder Emails, Send Signature Request, Send Signature Request From Template, Split Document, Summarize Document, Translate Document, Update Signature Request

Under **Scopes**, select each scope listed and clear any others.

<ul>
  <li>**Account Info**: **View basic account information**</li>
  <li>**Files (Documents)**: **Manage Lumin PDF files**</li>
  <li>**Signature Requests**: **Manage signature requests** and **View signature requests**</li>
  <li>**Templates**: **Manage Lumin templates**</li>
  <li>**Agreements**: **Manage agreements**</li>
  <li>**Workspaces**: **Manage Workspace** and **View user’s Workspaces**</li>
</ul>

![The Scopes section with the required scopes selected and highlighted](https://mintcdn.com/stackone-60/J806qduiWbw3dQTz/connectors/lumin/images/oauth2-setup-scopes.png?fit=max\&auto=format\&n=J806qduiWbw3dQTz\&q=85\&s=df8651ce06325e020c93abcddab39ebd)

<ul>
  <li>
    profile.read
  </li>

  <li>
    pdf:files
  </li>

  <li>
    sign:requests
  </li>

  <li>
    sign:requests.read
  </li>

  <li>
    templates
  </li>

  <li>
    agreements
  </li>

  <li>
    workspaces
  </li>

  <li>
    workspaces.read
  </li>
</ul>

**4. Set the redirect URI**

In **Redirect URI(s)**, enter the **Callback URL** from your Connector Profile.

![The Redirect URI(s) field highlighted](https://mintcdn.com/stackone-60/J806qduiWbw3dQTz/connectors/lumin/images/oauth2-setup-redirect-uri.png?fit=max\&auto=format\&n=J806qduiWbw3dQTz\&q=85\&s=47e1e207f9ade3ceffc2711f781c6797)

**5. Fill in the consent screen**

Under **Consent screen**, add the details users see when they authorize the app.

<ul>
  <li>**App logo**: Your company logo</li>
  <li>**Website**: Link to your website</li>
  <li>**Privacy Policy URL**: Link to your privacy policy</li>
  <li>**Terms of Use URL**: Link to your terms of use</li>
  <li>**Contact email**: Address users can contact with questions about their consent</li>
</ul>

![The Consent screen section with the App logo, Website, Privacy Policy URL, Terms of Use URL and Contact email fields highlighted](https://mintcdn.com/stackone-60/J806qduiWbw3dQTz/connectors/lumin/images/oauth2-setup-consent-screen.png?fit=max\&auto=format\&n=J806qduiWbw3dQTz\&q=85\&s=903032d5b85e30fde309a60ae886264f)

**6. Create the app**

Click **Create**.

![The bottom of the Create an application form with the Create button highlighted](https://mintcdn.com/stackone-60/J806qduiWbw3dQTz/connectors/lumin/images/oauth2-setup-create.png?fit=max\&auto=format\&n=J806qduiWbw3dQTz\&q=85\&s=39f1f2eabdb955d7381fa8472d09d50d)

**7. Copy the credentials**

Copy the **Client ID** and **Client Secret** into your Connector Profile.

<ul>
  <li>Click the copy icon next to each value.</li>
  <li>The **Client Secret** is only shown once.</li>
</ul>

![The Application created dialog with the copy icons next to the Client ID and Client Secret highlighted](https://mintcdn.com/stackone-60/J806qduiWbw3dQTz/connectors/lumin/images/oauth2-setup-copy-credentials.png?fit=max\&auto=format\&n=J806qduiWbw3dQTz\&q=85\&s=627dc5fdbb817812569eae5bf5a59024)

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


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