Setting Up Facility Grid Issues Log Synchronization with Procore

Click here to access the setup instructions for the Project Health Embedded Screens: https://facilitygrid.net/inquire/help/docs/setting-up-facility-grid-project-health-embedded-screens-in-procore/

Facility Grid allows to link active projects to Procore and establish an automated/real-time Issues Log synchronization. Once linked, project participants would have a choice of creating and responding to issues in Facility Grid, or creating and commenting on commissioning observations in Procore. All content, including the attached pictures and documents, is synched between the two platforms automatically.

IMPORTANT: If you currently have the Facility Grid App added to the project in Procore, please remove it before proceeding.

IMPORTANT: If you are trying to convert an existing project that was previously connected to Procore using a “Service Account”, please follow the steps below and in Step 11 click on “Convert” button instead of “Authorization”.

NOTE: For the synchronization to work correctly and to ensure that the responsibilities are properly assigned, the project participants in Facility Grid and Procore should match (by email) as much as possible.

NOTE: Facility Grid will send all project issues to Procore, but retrieve observations only with type “Commissioning” from Procore.

Begin by adding Facility Grid App to your project in Procore.

1. Log in to Procore and open the project you’d like to integrate:

2. Click on the Apps drop-down and select Marketplace

3. In the Marketplace, search for Facility Grid and follow the prompts to install the App.

4. During the App installation, Procore will prompt to confirm the permissions required by the Facility Grid app.  Click on “Install” to confirm.

5. Procore will display “Installation Successful” message.  Close the message by clicking on the “X” button.

6. On the App Management screen, click “View” next to the Facility Grid app

8. Click on the “Permissions” tab at the top

9. On the right hand side, under “Permitted Projects”, make sure to select all projects that will be integrated with Facility Grid. 

10. Open Facility Grid and navigate to the project you would like to integrate with Procore.

11. On the Settings page, navigate to Options -> Procore Integration, and click on “Authorization”. Important: If you are converting an existing project that was previously connected to Procore using a Service Account, click on “Convert”.

12. On the “Procore Integration” pop-up, copy and paste the required URLs and click “Connect”:

a. For Procore Company URL, in Procore, click on the Home button in the top left corner and copy the full URL displayed by your browser

b. For Procore Project URL, navigate to your project in Procore and copy the full URL displayed by your browser

13. Facility Grid will connect to Procore and retrieve project information.  Confirm the connection.

NOTE: If you receive a message stating that the project or company is not found, please make sure both URLs are correct, and the project permission in Procore is granted.

14. Once the setup is completed, on the Procore Integration tab, click on the “Initial Synchronization” button.  This will trigger full synchronization between Facility Grid and Procore.

Depending on the size of your project, it may take several minutes for the issues to show up in Procore. Facility Grid will display the “Currently synchronizing…” message until the process is completed. You will also see this message while the real-time sync is in progress.

15. To connect additional Facility Grid project to Procore, make sure Facility Grid App in Procore has permission to access the project in Procore, and repeat steps 8 through 12.

Additional Information:

Facility Grid Issues Status to Procore Observation Status mapping:

  • When originating from Facility Grid
FG Issue StatusProcore Observation Status
Draftobservation will not be created
Open and Any Other StatusInitiated
ClosedClosed
DeferredClosed
Work CompletedReady for Review
Pending ApprovalReady for Review
In ReviewReady for Review
  • When originating from Procore
Procore Observation StatusFG Issue Status
Initiated or Any Other StatusOpen
ClosedClosed
Ready for ReviewWork Completed
Not AcceptedNot Accepted

For further assistance, please contact the Facility Grid Support Team (support@facilitygrid.com)