You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
sub_header: Learn about the benefits, requirements, and steps to join the Procore Technology Partner Program.
3
+
title: Marketplace & Partner Overview
4
+
sub_header: Learn about listing an app on the Procore Marketplace, and steps to join the Procore Technology Partner Program.
5
5
layout: default
6
6
section_title: App Marketplace
7
7
---
8
8
9
9
## Introduction
10
-
The Procore Technology Partner Program empowers partners to integrate their solutions with Procore, showcasing their apps on the Procore Marketplace. By becoming a partner, you join a community dedicated to advancing construction management through integrated, cloud-optimized solutions that enhance project workflows, increase efficiency, and scale businesses.
10
+
Listing an app on the Procore Marketplace is reserved for Procore Partners, who are required to join the Procore Technology Partner Program. By becoming a partner, you join a community dedicated to advancing construction management through integrated, cloud-optimized solutions that enhance project workflows, increase efficiency, and scale businesses.
11
11
12
-
This page provides an overview of the benefits, requirements, and steps to join the program, helping you get started with listing your integration on the Procore Marketplace.
12
+
This page provides an overview of how to list an app on the Procore Marketplace, outlines the steps to join the Procore Partner Program, and highlights its benefits—helping you get started with listing your integration on the Marketplace.
13
13
<br><br>
14
14
15
15
***
@@ -34,26 +34,108 @@ There are no fees to join the Procore Technology Partner Program at this time. W
Create your account through the <a href="https://developers.procore.com/signup" target="_blank">Procore Developer Portal</a> to access the tools needed to build and manage your app.
42
-
<br><br>
43
-
<li><b>Explore the Developer Sandbox & Build Your App</b></li>
44
-
Experiment with Procore’s API by creating an app and testing it in your Developer Sandbox. Familiarize yourself with Procore’s capabilities and app framework, and gather feedback from mutual customers to refine your solution.
45
-
<br><br>
46
-
In addition to the Developer Sandbox, leverage our self-service learning offerings through our <a href="{{ site.url }}{{ site.baseurl }}{% link overview/help_and_learning_center.md %}">Help & Learning Center</a>.
47
-
<br><br>
48
-
<li><b>Submit Your Request for Partner Review</b></li>
49
-
Initiate the review process by selecting 'Become a Partner' within the Marketplace Listing tab in your app.
50
-
<br><br>
51
-
<li><b>Agree to the Partnership Agreement</b></li>
52
-
After passing review, sign or accept the Procore Partner Agreement sent to your email to officially join the program.
53
-
<br><br>
54
-
<li><b>Finalize & Publish Your App</b></li>
55
-
Once approved as a partner, gather feedback from from a beta customer to finalize your initial app version, then submit your app to be published on the Procore Marketplace, making it accessible to thousands of potential users.
<p class="step-description">Leverage Procore's co-marketing resources to promote your app and engage customers.</p>
135
+
</div>
136
+
</div>
137
+
</div>
138
+
</div>
57
139
<br>
58
140
59
141
***
@@ -70,7 +152,7 @@ There are no fees to join the Procore Technology Partner Program at this time. W
70
152
71
153
Procore Technologies reserves the right to revise the Developer Documentation at any time, in its sole discretion.
72
154
73
-
As described in the applicable terms and conditions, Procore may remove or decline the publication of anyMarketplace Listing at any time.
155
+
As described in the applicable terms and conditions, Procore may remove or decline the publication of any Marketplace Listing at any time.
74
156
75
157
<!-- All prospective partners are required to complete Procore’s vetting process before contracting. Participation in the Partner Program is contingent on adherence to the Program Guide, the applicable Procore Partner Agreement, and the Partner Code of Conduct, which are available <a href="https://www.procore.com/partners/documents" target="_blank">here</a>. -->
Copy file name to clipboardExpand all lines: app_marketplace/update_your_marketplace_app.md
+65-48Lines changed: 65 additions & 48 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,88 +7,105 @@ section_title: App Marketplace
7
7
---
8
8
9
9
## Introduction
10
-
As your app evolves over time, you may need to update its functionality, content, Marketplace Listing, or app features. You can update these items anytime in your app through the <ahref="https://developers.procore.com/developers"target="blank">Procore Developer Portal</a>.
11
10
12
-
It's important to note that you need to submit these changes to be reviewed and approved by the Procore Marketplace team. While changes to your source code itself do not require approval, any modifications that impact functionality or how your integration interacts with Procore must be reviewed.
11
+
As your app evolves, you may need to update its functionality, features, or Marketplace Listing. These updates can be made at any time through the <ahref="https://developers.procore.com/developers"target="_blank">Procore Developer Portal</a>.
12
+
13
+
If you’re unable to access the app in the Developer Portal, review [Managing App Collaborators]({{ site.url }}{{ site.baseurl }}{% link building_applications/building_apps_manage_collabs.md %}) to confirm your permissions or request access from your internal team.
14
+
15
+
While changes to your app’s **source code** do not require approval, **any updates that impact functionality or how your app interacts with Procore must be submitted for review and approved by the Procore Marketplace team.**
13
16
<br><br>
14
17
15
18
***
16
-
## Update Marketplace Listing
17
-
You can easily update the information shown on your Marketplace Listing directly in your app through the <ahref="https://developers.procore.com/developers"target="blank">Procore Developer Portal</a>.
18
19
19
-
It's important to note that you must have access to the corresponding app and have the appropriate role applied. If you do not see the app you wish to update after logging into the Procore Developer Portal, reach out to your internal team for them to invite you.
20
+
## Update Your Marketplace Listing
21
+
22
+
You can update your app’s Marketplace Listing directly within the <ahref="https://developers.procore.com/developers"target="_blank">Procore Developer Portal</a>.
23
+
24
+
Before updating, make sure:
25
+
- You have access to the app
26
+
- You’re assigned an appropriate role (Admin or Owner)
27
+
28
+
If you don’t see the app after logging in, ask your internal team to invite you.
20
29
<br><br>
21
-
<!-- To learn how to add additional collaborators to your app, visit [Manage App Collaborators](LINK HERE).
22
-
<br><br> -->
23
30
24
31
***
32
+
25
33
## Update App Functionality
26
-
If you wish to update your app's functionality or features, follow the steps below:
27
-
<br><br>
34
+
35
+
If you're adding new features or modifying existing functionality, follow the appropriate steps below.
36
+
37
+
---
28
38
29
39
<details>
30
-
<summaryclass="collapseListTierOne">Add Additional API Routes</summary>
40
+
<summaryclass="collapseListTierOne">Add API Routes</summary>
31
41
<p>
32
-
To expand your app's functionality, explore additional API routes by referring to the <ahref="https://developers.procore.com/reference/rest/docs/rest-api-overview"target="blank"> Procore Rest API Overview</a>. Identify the required routes for creating, updating, or reading data from Procore, and integrate them into your source code.
33
-
<br><br>
34
-
If your app uses the <b>Service Account Authentication</b> grant type, make sure to update the tool permissions to prevent errors.
42
+
To expand your app’s capabilities, you can integrate additional API routes. Refer to the <ahref="https://developers.procore.com/reference/rest/docs/rest-api-overview"target="_blank">Procore REST API Overview</a> to identify relevant endpoints for reading, writing, or updating data.
43
+
44
+
If your app uses the <b>Service Account Authentication</b> grant type, remember to update tool permissions to avoid errors or failed calls.
If you've previously developed an app and wish to include an additional [available app type](LINK HERE), you can do so by simply updating your existing app within the Procore Developer Portal and referencing the followings guides for the specific app types:
55
+
If you want to add another supported <b>App Type</b> (e.g., embedded UI or data connector), you can update your existing app in the Developer Portal.
43
56
57
+
See guides for:
44
58
<ul>
45
-
<li>To add the full-screen embedded app type, visit [Build a Full-Screen App](LINK HERE).</li>
46
-
<li>To add the side panel embedded app type, visit [Build a Side Panel App](LINK HERE).</li>
47
-
<li>To add the authorization code data connector app type, visit [Build a Authorization Code App](LINK HERE).</li>
48
-
<li>To add the client credential data connector app type, visit [Build a Client Credential App](LINK HERE).</li>
<summaryclass="collapseListTierOne">Update Embedded or Iframe Properties</summary>
56
70
<p>
57
-
If you're considering updating your full-screen or side panel app by changing the URL source, adding additional views or incorporating parameter interpolation, follow these steps:
71
+
If you're changing your app’s embedded experience—such as modifying the iframe URL, adding views, or using parameter interpolation—follow these steps:
58
72
59
73
<ol>
60
-
<li>Access your app via the <a href="https://developers.procore.com/developers" target="blank">Procore Developer Portal</a> and click the pencil icon to the right of the component you wish to edit.</li>
61
-
<li>Update the information as needed, such as changing the URL, selecting different views or adding parameter interpolation.</li>
62
-
<li>Select <b>Save Component</b> in the bottom right corner.</li>
63
-
<li>Click <b>Save Version</b> to confirm the changes and create a new version for the Developer Sandbox.</li> <!-- WIP it would be good to link out to 'What is the Developer Sandbox' here -->
64
-
<li>Test the changes by <a href="https://support.procore.com/products/online/user-guide/company-level/admin/tutorials/install-a-custom-app" target="blank">Installing Your App</a> in the Developer Sandbox as a custom app.</li>
65
-
<li>When you're satisfied with the changes, click <b>Promote Version</b> to make the changes available in the production environment and then <b>Submit for Review</b> to notify the Procore Marketplace team for approval.</li>
74
+
<li>Open your app in the <ahref="https://developers.procore.com/developers"target="_blank">Developer Portal</a>.</li>
75
+
<li>Click the pencil icon next to the embedded component you want to edit.</li>
76
+
<li>Update the required fields (e.g., iframe URL, views, interpolation parameters).</li>
77
+
<li>Click <b>Save Component</b>.</li>
78
+
<li>Click <b>Save Version</b> to commit your changes and generate a new version for testing.</li>
79
+
<li>Test the update in your sandbox by <ahref="https://support.procore.com/products/online/user-guide/company-level/admin/tutorials/install-a-custom-app"target="_blank">installing the app as a custom app</a>.</li>
80
+
<li>Once you're satisfied with the results, click <b>Promote Version</b> to apply the changes to the production environment, then <b>Submit for Review</b> for approval.</li>
If you're expanding your app's functionality, ensure you update the required permissions to prevent errors. Here's how to proceed based on your grant type:
90
+
If you're expanding your app’s scope, update its tool permissions based on the authentication method in use:
91
+
75
92
<ul>
76
-
<li>For apps using <b>UserLevel Authentication</b>:</li>
77
-
<ul>
78
-
<li>Since permissions are user-specific, you can't directly manage them. However, consider updating your app requirements on the Marketplace Listing.</li>
79
-
</ul>
80
-
<br>
81
-
<li>For apps using <b>Service Account Authentication</b>:</li>
82
-
<ol>
83
-
<li>Access your app via the <a href="https://developers.procore.com/developers" target="blank">Procore Developer Portal</a> and click <b>Add Components</b> or <b>Edit Permissions</b>.</li>
84
-
<li>Update the information as needed, such as changing the permissions or selecting a different authentication type.</li>
85
-
<li>Select <b>Save Component</b> in the bottom right corner.</li>
86
-
<li>Click <b>Save Version</b> to confirm the changes and create a new version for the Developer Sandbox.</li> <!-- WIP it would be good to link out to 'What is the Developer Sandbox' here -->
87
-
<li>Test the changes by <a href="https://support.procore.com/products/online/user-guide/company-level/admin/tutorials/install-a-custom-app" target="blank">Installing Your App</a> in the Developer Sandbox as a custom app.</li>
88
-
<li>When you're satisfied with the changes, click <b>Promote Version</b> to make the changes available in the Production environment and then <b>Submit for Review</b> to notify the Procore Marketplace team for approval.</li>
89
-
</ol>
93
+
<li><b>User-Level Authentication:</b><br>
94
+
Permissions are tied to the end user’s Procore account and cannot be managed directly. However, you should update your Marketplace Listing to reflect any new tool requirements.</li>
95
+
96
+
<li><b>Service Account Authentication:</b><br>
97
+
Follow these steps to update your app’s tool access:
98
+
<ol>
99
+
<li>Open your app in the <ahref="https://developers.procore.com/developers"target="_blank">Developer Portal</a> and click <b>Add Components</b> or <b>Edit Permissions</b>.</li>
100
+
<li>Update your tool permissions or authentication type as needed.</li>
101
+
<li>Click <b>Save Component</b>.</li>
102
+
<li>Click <b>Save Version</b> to finalize your changes.</li>
103
+
<li>Test the update in the sandbox by <ahref="https://support.procore.com/products/online/user-guide/company-level/admin/tutorials/install-a-custom-app"target="_blank">installing the app as a custom app</a>.</li>
104
+
<li>Once confirmed, click <b>Promote Version</b> and then <b>Submit for Review</b> for approval.</li>
105
+
</ol>
106
+
</li>
90
107
</ul>
91
108
92
-
It's important to note that if your app uses a Service Account Authentication, it must adhere to the principle of least privilege, granting access only to the tools it integrates with and using the minimum required permissions.
109
+
> Apps using Service Account Authenticationmust follow the principle of least privilege—only requesting access to the tools and permissions essential to their function.
0 commit comments