A Partner Integration is the preferred way when you want to integrate with many different places.
To create a Partner Integration in Parakey you need to contact us and explain its purpose. Once you are approved we will activate the development hub, a dashboard where you manage your integration in Parakey Web Portal.
How to get started
Before you get approved as an Integration partner you can follow the instruction in Create a Manual Integration article to get started and try to invite users to your own domain.
Moving to a production-ready integration
Once you have tested your integration using the Manual Integration and you are satisfied with how it works, please contact [email protected] with
An email address to use for your integration. It needs to be a generic email that you have access to. For example [email protected] or [email protected].
An explanation of the purpose of your integration.
What API endpoints your integration is using.
Description of triggers in your integration. If triggers are event based, what kind of events. If triggers are scheduled, when and how often is the scheduled triggered.
Contact information for your integration.
We will then create an Partner Integration account for you. When you sign in you will see the following development dashboard.
The development hub is where you manage your API places, Access tokens and webhooks for your integration
Generate Access token for your integration
Once your Partner Integration account is up and running you can create an Access token to use for your integration. You can create up to 5 Access tokens per integration. You can reuse the same Access token for all places you integrate with.
How to add your integration to a new customer
When a new customer wants to add your integration to their place, all they have to do is add your Application ID to their Partner Integration settings by following the instructions in the article Add a Partner Integration.
Your integration will then have access to manage this place. You should see it in the list of Your API Places on your development dashboard.