Skip to main content
The Lucid Developer Portal is only available to users with the developer role on a Lucid team plan. On a free personal account the portal is locked — ask your Lucid admin to assign you the developer role before creating an OAuth 2.0 client.

​
Create a Lucid OAuth 2.0 client

Register an application in the Lucid Developer Portal to obtain the Client ID and Client Secret used for OAuth 2.0 authorization.

1

Sign in to Lucid

Sign in to the Lucid Developer Portal with a user that has the developer role on your Lucid account.

2

Create an application

On the Applications tab, click Create Application and give the app a name.

  • Open the app you just created to view its configuration.
3

Create an OAuth 2.0 client

Open the OAuth 2.0 tab of your application and create a new OAuth 2.0 client.

  • Under Redirect URIs, click Add Redirect URI.
  • Add the StackOne callback URL exactly: https://api.stackone.com/connect/oauth2/lucid/callback
4

Configure the required scopes

Enables actions: Add Team Users, Archive Team, Copy Document, Create Document, Create Document Share Link, Create Folder, Create Folder Share Link, Create Mermaid Diagram, Create Team, Create User, Delete Document Share Link, Delete Folder Share Link, Get Account, Get Profile, Post Thread Comment, Remove Document Team Collaborator, Remove Document User Collaborator, Remove Folder Team Collaborator, Remove Folder User Collaborator, Remove Team Users, Restore Folder, Restore Team, Set Document Team Collaborator, Set Document User Collaborator, Set Folder Team Collaborator, Set Folder User Collaborator, Trash Document, Trash Folder, Update Document, Update Document Share Link, Update Folder, Update Folder Share Link, Update Mermaid Diagram, Update Team

Grant the OAuth client the scopes the connector’s actions need. Users approve these scopes on the Lucid consent screen when they connect their account.

  • Include offline_access so Lucid issues a refresh token (access tokens expire after 1 hour).
5

Copy the Client ID and Client Secret

Copy the generated credentials and paste them into the StackOne Connector profile.

  • Copy the Client ID value into the Client ID field in the StackOne Connector profile.
  • Copy the Client Secret value into the Client Secret field in the StackOne Connector profile.
  • The Client Secret is shown only once — store it securely before leaving the page.

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Lucid:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Lucid
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Lucid.