Developer Hub

Developer Hub, formerly Marketplace Manager, is a tool for creating and maintaining your app in the Pipedrive Marketplace. It’s the starting point for your app creation process and where you create and maintain it. Everything you need to do to create and support your app is done through Developer Hub.

Developer sandbox

You can access Developer Hub by logging in to your developer sandbox account and going to Settings > (company name) Developer Hub. Through it, you can:



Save a draft app


First, you need to save a draft app to start working on your app. Why? Because this is where you’ll get your client_id and client_secret – 2 crucial elements required for OAuth authorization. Learn how to get them here.

The two main required fields that are necessary to save your draft app are your app name and the OAuth callback URL. All other fields marked as required will be validated when you send your app to review.

📘

Take note: If you initially inserted a non-functioning OAuth callback URL, make sure you change it to a functioning one before submitting it for approval.



Registering your app


🚧

NB: Do pick your app type carefully, as it cannot be changed later on Developer Hub.

Registering public apps

Registering your app is a major step in the app creation process before you send it off for the app approval process. This is when you fill out all the details of your app and its listing page on the Pipedrive Marketplace.

To give your app users a good user experience, there are three crucial aspects to take note of when registering your app:

Marketing

Along with your app’s name and icon, the General Info tab is where you should include marketing details about your app.

What exactly does your app do? Why is its integration with Pipedrive useful? Tell users about it through a summary, a longer description, app listing images and a video link.

Scopes and permissions

The OAuth & access scopes tab is where you will specify the types of data your app needs access to, depending on the endpoints your app uses.

It’s important to choose only the scopes necessary for your app. Start by choosing the least amount of scopes needed, then enable additional scopes – according to this mapping – based on the endpoints used in your app.

Installation flows

Before sending your app to review, check to ensure that your app handles our main pre-defined installation and uninstallation flows. This is mandatory for all public apps. Your app should present a unified experience as users authorize access to their data and account for all installation scenarios. Read more about app installation flows here.

Registering private apps

There is a slightly different flow for registering your private app. Private apps can be shared with any user/company in Pipedrive via a direct, unlisted installation link. They don’t have to go through the app approval process and will not be published in the Pipedrive Marketplace.

Hence, private apps will only have to fill out the parts of the app registration form that cover app creation.



App status


The app’s status is displayed in a pill next to the app name in Developer Hub.

Developer Hub - apps list

Public apps status

Public apps can have four statuses:

App statusDescription
App status - draftYour app is in a draft state. Please start installing and testing it before sending it for review.
App status - reviewYour app has been sent for review and is being reviewed by the Marketplace team.
App status - unpublishedYour app is approved by the Marketplace team. It remains unpublished as you have to publish it yourself.
App status - published/liveYour app is published and publicly visible in the Pipedrive Marketplace.

Private apps status

Private apps can have two statuses:

App statusDescription
App status - draftYour app is in a draft state. It can be shared with users in the same Pipedrive company.
App status - draftYour app is live and can be shared with any company in Pipedrive via its direct, unlisted installation link.


Updating and maintaining your app


Updating your app to maintain it is similar to registering it. Within Developer Hub, you can make various changes to your app listing, such as your app listing’s images, video (YouTube) link, descriptions and more.

This is where you can also make more significant changes, such as:

  • Changing the scopes of your app
  • Changing your app name
  • Hiding your app to unlist it

Depending on what you change/edit in your app, you may have to go through the app approval process again. Learn how to update approved apps here.


Deleting your app


Should you wish to remove your app from the Pipedrive Marketplace, you can do so via Developer Hub. Find out more about how to delete your app here.

Deleting your app means it will no longer be visible in Developer Hub nor listed in the Pipedrive Marketplace. It will also be uninstalled from all existing customers.