Enterprise Settings - Developer
Only available for
Allow Enterprise admins to create new applications to which Enterprise users can subscribe. Admins can manage and distribute these applications to specified users.
Enterprise admins can also create, view, and delete API keys for the Enterprise.
For more information on working with Onshape applications, please see the Onshape API Developer Documentation.
To navigate to your Developer settings in Onshape, click on your Account user icon () in the top right corner of your Onshape window. This opens a dropdown menu. Click Enterprise settings.
Click Developer in the list on the left side of the page:
What the Enterprise admin can do from this screen
-
Create an internal application in the company settings without going to the App Store dev portal
-
Manage the application internally
-
View, create, and delete API keys for anyone in the Enterprise

-
Click the OAuth applications link:
-
Click the Create new OAuth application button:
-
Fill out the information as follows (note that detailed information is also provided on-screen):
-
Name - Name of the application displayed to users.
-
Primary format - Unique string to identify your application that is not displayed to the user.
-
Summary - Information about the application.
-
Redirect URLs - URL to which you are redirected after authentication.
-
Type - Application type. Options are Integrated Cloud App, Connected Cloud App, or Connected Desktop App.
-
OAuth URL - URL used to start the OAuth process from the Onshape Applications page.
-
Settings
-
Supports collaboration - Check if you wish to collaborate with other users when developing the application.
-
- Permissions - See Permission scopes below.
-
-
Click Create application.
-
Use the Search members field to locate and select users to join in application development and/or testing.
-
The Authorize application screen to allow access to the application is provided to the user:
-
For information on authenticating your applications with OAuth, see API Guide: Authentication.

Viewing API keys
- In your Enterprise Developer settings, click API keys
- Review the API keys available for the Enterprise.
Creating API keys
- In your Enterprise Developer settings, click API keys
- Click Create new API key.
- Provide a name for the API key in the Name field.
-
Assign the API key to someone in the Enterprise. You can search by name or email in the User field.
Enterprise users can see API keys assigned to them by going to the Onshape Dev Portal and clicking API keys in the left pane.
- Choose the permissions for the keys. See Permission scopes below.
- Click the Create API key button.
-
In the pop-up window, copy the API key and secret key shown, save them somewhere, then click the Close button.
You will not be able to find the secret key again, so save it somewhere safe!
- For information on authenticating your applications with API keys, see API Guide: Authentication.
Deleting API keys
- Click the "X" icon to the right of the API key you wish to delete.
- Confirm that you want to delete this API key for all users. This action cannot be undone. Click Delete to confirm.

The following permission scopes are available when creating OAuth applications:
-
Application can read your profile information (OAuth2ReadPII) - Check to allow the application access to information on your profile.
-
Application can read your documents (OAuth2Read) - Check to allow the application read access to your documents.
-
Application can write to your documents (OAuth2Write) - Check to allow the application write access to your documents.
-
Application can delete your documents and workspaces (OAuth2Delete) - Check to allow the application access to delete your documents and workspaces.
-
Application can request purchases on your behalf (OAuth2Purchase) - Check to allow the application the ability to make purchase for you.
-
Application can share and unshare documents on your behalf (OAuth2Share) - Check to allow the application the ability to share and unshare your documents.