Developer Hub, formerly known as 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.
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 and get your
- Register your app
- Update and maintain your app
- Delete your app
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_secret – 2 crucial elements required for OAuth authorization.
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.
How to get your client_id and client_secret
Your app’s unique
client_secret are values you need to go through OAuth authorization and receive the
refresh_token to be used in API requests.
To obtain these values, you will have to:
- Log in to your developer sandbox account and go to Settings > (company name) Developer Hub
- Click on “Create an app” or “+ Create an app” if you have existing apps
- Choose whether you would like to create a public or private app
- In the Basic Info tab of Developer Hub, fill in the required fields – App name and OAuth Callback URL
- You can insert a non-functioning OAuth Callback URL for the time being. After implementing the logic needed for accepting user authorization in your code, you will have to update the field with a proper URL.
- Keep in mind that we allow only one callback URL per app
- Click the green “Save” button to save the form
- You’ll automatically be brought to the second tab, “OAuth & access scopes”, where you’ll get your
Once you’ve received these, you can start working on your app!
Take note: If you inserted a non-functioning OAuth callback URL in the beginning, do make sure you change it to a functioning one before submitting it for approval.
Registering your app
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 important aspects to take note of when registering your app:
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.
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.
The app’s status is displayed in a pill next to the app name in Developer Hub.
Public apps status
Public apps can have four statuses:
|Your app is in a draft state. Please start installing and testing it before sending it for review.|
|Your app has been sent for review and is being reviewed by the Marketplace team.|
|Your app is approved by the Marketplace team. It remains unpublished as you have to publish it yourself.|
|Your app is published and publicly visible in the Pipedrive Marketplace.|
Private apps status
Private apps can have two statuses:
|Your app is in a draft state. It can be shared with users in the same Pipedrive company.|
|Your 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.
Updated 8 days ago