Kulea can be integrated with your Vincere account, meaning you can manage all of your data in Vincere and automatically have those changes reflected in Kulea overnight (or at a frequency determined by you). The process to connect the two systems is simple. Kulea offers a full integration service, details are available on request.  Kulea will then handle most of the work, though there are some steps which require your involvement. 


Step 1. Request Credentials

The first step is to request the API credentials from Vincere. You will need to provide Vincere with your redirect url, and by return they will send you your API key and Client ID.


To access your call back url, simply go to https://[[ma2id]].prod.kulea.marketing/oauth2/request.html. From here, you can copy and paste your redirect url.


 

Simply send your redirect url to Vincere via the Vincere support desk, and by return they will provide you with the following credentials:


  • API Key, e.g. 
    1234ab56cde789fg9123h456i7j89123 

  • Client ID, e.g.
    027d0137-4631-4e24-9c51-02d541747e56

Step 2. Register your ID

Enter your client ID into the second field at https://[[ma2id]].prod.kulea.marketing/oauth2/request.html and click the register client button.


Step 3. Connect to Vincere


 Your client ID will either be rejected (speak to Vincere), or accepted and registered.


You can now request your token...


To generate your tokens, you will now need to connect to Vincere and log in using your standard Vincere login details



 

Step 4. Grab your tokens

 

Once signed in through Vincere, you will be redirected to your tokens page.  Please send your Kulea account manager a copy of your refresh token and your ID token (provided to you by Kulea - see below), alongside the API key and Client ID that Vincere sent you originally.  For security reason, we recommend sending this information through a.secure channel, such as onetimesecret.com.  Once sent, please close down the token window.




Note, we do not need your Access token


Step 5. mapping your fields

At this point we will also require any additional information on how you want to map data from Vincere, for example:

  • Client/candidate fields fields that will require pulling from Vincere to Kulea (we recommend only pulling data that can be used to segment or personalise email campaigns - please note that we will not map any fields that contains private data eg. financial data, private personal data etc.

  • Date to import from

  • Any filters you would like applied to the data transfer

  • Any custom field or non-standard mapping requirements 

That's it - we can now crack on! 

Should you require any further changes to your integration then please don't hesitate to contact Kulea and we'll be delighted to make those changes for you.


Notes on DIY integrations


If you are handling the integration yourselves then you can use the credentials provided in the process above to access your tokens

 

POST https://id.vincere.io/oauth2/token?client_id=[client ID&refresh_token=[Refresh token]&grant-type=code

 

with a header: Content-type: application/x-www-form-urlencoded

 

To call the API then an example of the URL will be:

 

GET https://[your company].vincere.io/api/v2/candidate/111222

 

with headers:

 

id-token = [ID token]

x-api-key = [API key]

Content-type = application/json