Skip to main content
Only the Owner of a Lumin Workspace can create integration apps.

​
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, then click Settings > Developer settings.

  • Click the Integration apps tab.
  • Click Create app.
The Integration apps tab with the Create app button highlighted
2

Enter the basic information

Under Basic information, fill in the app details.

  • Application name: StackOne Integration
  • Application type: Private (Server) application
The Basic information section with the Application name field and the Private (Server) application option highlighted
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.

  • Account Info: View basic account information
  • Files (Documents): Manage Lumin PDF files
  • Signature Requests: Manage signature requests and View signature requests
  • Templates: Manage Lumin templates
  • Agreements: Manage agreements
  • Workspaces: Manage Workspace and View user’s Workspaces
The Scopes section with the required scopes selected and highlighted
4

Set the redirect URI

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

The Redirect URI(s) field highlighted
5

Fill in the consent screen

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

  • App logo: Your company logo
  • Website: Link to your website
  • Privacy Policy URL: Link to your privacy policy
  • Terms of Use URL: Link to your terms of use
  • Contact email: Address users can contact with questions about their consent
The Consent screen section with the App logo, Website, Privacy Policy URL, Terms of Use URL and Contact email fields highlighted
6

Create the app

Click Create.

The bottom of the Create an application form with the Create button highlighted
7

Copy the credentials

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

  • Click the copy icon next to each value.
  • The Client Secret is only shown once.
The Application created dialog with the copy icons next to the Client ID and Client Secret highlighted

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

Link an Account

Once the Connector Profile is created, continue to link an account.