Creating a New Application
Once you have registered your Developer Account you can create a new Application in the Procore Developer Portal. The following steps show you how to properly navigate the Developer Portal and successfully create a new Application.
- First, open your browser and navigate to the Developer Portal landing page.
- Click ‘Sign In’ to log in to your Developer Portal account.
- Navigate to the My Apps page and click ‘Create a New App’. The Create New App dialog displays.
- Enter an App Name, a meaningful Description, select an Integration Type, and select a Category for your application, then click Create.
The configuration page for your newly created application comprises a number of sections. Let’s explore those in the sections below.
The App Settings section includes all the field values you specified when you first created your application, along with additional fields that let you enter a Support Email address and Support Phone Number, as well as a Site URL for your company website.
The App Credentials section includes the fields that specify the Client ID, Client Secret, and OAuth Redirect URI for your application. These data are used for implementing OAuth 2.0 authentication for your application.
- Client ID - Generated automatically when you create a new application. The Client ID is a publicly exposed string that is used by the Procore API to identify your application, and is also used to build authorization URLs that are presented to your users.
- Client Secret - Generated automatically when you create a new application. The Client Secret is used to authenticate the identity of your application to the Procore API when your application requests to access a user's Procore account, and must be kept private between the application and the API.
- OAuth Redirect URI - Procore will redirect the user to this URI after they authorize your application, and is the part of your
application that will handle authorization codes and/or access tokens. A default value of
http://localhostis available when you first create your application and can be used for testing. You can enter additional Redirect URIs as a whitespace-delimited list. For server-side web applications, use a
https://web address. For installed applications (or backend scripts, cron jobs, etc.) use
The Sandbox Account section is where you generate a development sandbox that you can use to build and test your application. Development sandboxes come pre-seeded with test data at the company and project levels. We go into greater detail on the sandbox generation process in the next lesson module.
If you manage a team of developers you can use the Manage Collaborators section to add team members and assign them to admin or developer roles. You can ‘View Permissions Details’ to see which Developer Portal tasks each role is allowed to perform. For example, Admins are allowed to View App Credentials, Manage Users (team members), and Update App Settings, while Developers are only allowed to View App Credentials.
Delete this App
Finally, in the event you need to remove an existing application from your developer profile, you can scroll down to the Delete this App section and click ‘Delete App’.