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.

  1. First, open your browser and navigate to the Developer Portal landing page.
  2. Click ‘Sign In’ to log in to your Developer Portal account.
  3. Navigate to the My Apps page and click ‘Create a New App’. The Create New App dialog displays.
  4. Enter an App Name. This will be the name you use to refer to your application internally within your organization.
  5. Click Create.

The configuration page for your newly created application comprises a number of sections. Let’s explore those below.

App Settings

The App Settings section includes the App Name you specified when you first created your application, along with a space to upload a logo for your application if you want.

Marketplace Listing

Once you have completed the development phase of your integration project you may consider submitting your application for publication on the Procore App Marketplace. The following steps outline the process for submitting your application package.

  1. On each of the tabs in the Marketplace Listing section, enter the information you want to display on the application tile that customers see on the App Marketplace.
    • App
      • Name - A public-facing name for your application. (50 character max.)
      • Description - A thorough description of the features, capability, and functionality of your application. (500 character max.)
      • Tagline - A short marketing slogan summarizing the main beneift your application provides. (40 character max.)
      • Category - The product category that best fits your application, or choose 'Other' if that is more appropriate.
      • Built By - The name of the organization that developed your application. Normally, this is your company name.
      • About Your Company - Background information on your company.
      • How it Works - A description of how your application interacts with Procore including tools/resources and data flow.
    • Support
      • Support Email - The email address for your dedicated support team.
      • Support Phone - The telephone number for your support team.
      • Support Website URL - The URL for your support website.
      • Support Website Label - The text label displayed for the support website.
    • Features
      • Feature (1-3) - Three distinct application features that display as bullet items. (100 character max. each)
    • Links
      • Link URL (1-3) - Three optional URLs to web content that customers would find helpful.
      • Link Label (1-3) - Corresponding text labels for helpful links.
    • Required Product Lines
      • Project Management - RFI's, Submittals, Photos, Drawings, etc.
      • Quality & Safety - Inspections, Observations, Daily Log, etc.
      • Construction Financials - Prime Contract, Commitments, Change Orders, etc.
      • Field Productivity - Timesheets, Crews, etc.
    • Integration Requirements
      • Requirement (1-3) - Up to three integration requirements such as subscription tiers, product licensing, third-party systems, etc.
  2. Click Save Draft. Note that you can return to and update any of the field values at a later time if you wish.
  3. Once you are satisfied with your settings for the Marketplace Listing, click Submit for Review. You will be notified by email regarding the results of our review. If you have any specific questions you can click Contact Us to reach out to our App Marketplace validation team.

For additional information on submitting your application for review for publication on the Procore App Marketplace, please see the Technical Requirements and Sales and Support Requirements articles. Review the Technology Partners section for general information on the Procore Technology Partner Program.

Production Credentials

Once your application is ready for release, you must request Production Credentials in order to access the Procore production environment. These credentials are to be used only in the Procore production environment and may not be used for development purposes. Use the following steps to request Production Credentials for your application.

  1. Select whether your application is confidential or public depending on your authentication architecture.
  2. Click Request Production Access.
  3. Review the confirmation dialog. Click Request Production Access once again. Your Production Credentials display. You will need these keys for implementing OAuth 2.0 authentication for your application.
    • Client ID - a publicly exposed string used by the Procore API to identify your application, and to build authorization URLs that are presented to your users.
    • Client Secret - used to authenticate the identity of your application to the Procore API when your application requests access to a user's Procore account on their bahelf. The Client Secret must be kept private between the application and the API.
  4. Copy your Client Secret to a safe place. This is the only opportunity you will have to view/store your Client Secret.
  5. Click Back to return to the App Settings page.

Sandbox Account

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. See Sandbox Environments for additional detail on the sandbox generation process.

Manage Collaborators

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’.