Vincere Setup

For Cyclr to connect with the Vincere API you will need to select a suitable user account within Vincere. This account will require some setup as described below.

Warning: Some users have experienced issues when using the Safari web browser to sign in to Vincere so we would recommend using other web browsers.

  1. Login to the Vincere Application using the account specific URL, e.g.: https://{{yourdomain}}.vincere.io/loginForm.do
  2. Select Settings > Marketplace.
  3. Select the API Tab.
  4. Click “Create new token” button, this will display the API Key.
  5. Click “Create new Client ID” button, this will display the Client ID.
  6. Set the “Callback URL” field to your Cyclr Partner Console’s Callback URL.

Cyclr Connector Installation

When installing a Vincere Connector, the following values are used:

  • Client ID: Vincere Client ID.
  • Secret: Leave this blank.
  • Domain: This is the subdomain part of the URL used to access the Vincere account, e.g.: if the URL was https://yourdomain.vincere.io the value to provide here would be just “yourdomain“.
  • API Key: Vincere API Key.

Use Custom Fields

When you use custom fields, the Cyclr Field Location values vary based on the type of the custom field.

For example, to use Candidate custom fields:

  1. Run the Get Candidate Custom Fields Connector Method to list the available custom fields.
  2. Make note of the Key and Type fields shown in the response.

If you want to add a custom field to Get Candidate, the table below shows the Field Location you need to use depending on the field type.

Custom Field TypeField LocationExample
TEXT_BOXThe custom field’s Key12345678901234567890
TEXT_AREAThe custom field’s Key12345678901234567890
CHECK_BOXThe custom field’s Key within square brackets[09876543210987654321]
SELECT_BOXThe custom field’s Key within square brackets[09876543210987654321]
RADIOThe custom field’s Key within square brackets[09876543210987654321]
MULTIPLE_SELECTIONThe custom field’s Key within square brackets[09876543210987654321]

When you use List methods, such as List New Candidate Records, make sure to include the correct parent array. For example “[items].“

For more information, see the Cyclr documentation on how to add custom fields to a method.