Register your application

Register an application using the Trimble Cloud Console in order to create client credentials that will be used during API authorization.

An application is also what you will use when you are ready to set up Trimble Identity for user authentication with your application.

To register your application

1. Sign in to Trimble Cloud Console.

2. Click Applications.

3. On the Applications page, click + Create New Application (upper-right corner).

   The Create New Application modal displays.

4. Enter the Name, Display Name, and Description for your application:

   • Name

     This is a string that uniquely identifies your application within Trimble Identity (TID). This name will be used in OAuth scopes. This name cannot contain spaces.

   • Display Name

     When using Trimble Identity for user authentication, this is the name that will display on the sign in screen.

   • Description

     This is an optional field that is only visible within Trimble Cloud Console for your information.

   Click Create.

5. Trimble Cloud Console will direct you to your application details page, on the Overview tab. Here is where you can obtain your Client Id and Client Secret.

6. By default, the following Grant Types are enabled for every new application:

   • Client Credentials Grant
   • Device Code
   • Use Refresh Tokens
   • Token Exchange

   If you are setting up user authentication, you can enable the Authorization Code Grant on the GRANT TYPES tab. You must define at least one Allowed Callback URL before submitting the form.