Skip to main content
Skip table of contents

Candidate Hub

Candidate Hub makes use of OAuth 2.0 for remote API access.

For your reference, here is a link to the Mautic API documentation.

Before Starting

You will need to allow API access in your instance of Candidate Hub. To do this, go to settings and under the configuration tab, select API Settings, then yes under "API enabled?"

Adding a New Application

After you've allowed API access, you will need to follow these steps to be able to use the API with cyclr.

Step 1 - Under settings, you will find a new tab called API Credentials.

Step 2 - Once inside, select New in the top right corner

Step 3 - In this new screen, set Authorization Protocol to OAuth2, give it an appropriate name, and make the redirect URI your instance of Cyclr.

Step 3a - The Redirect URL should be https://{service domain}/connector/callback. Your service domain can be found in your Cyclr console under Settings > General Settings > Service Domain.

Step 4 - You'll be taken back to the API Credentials page and be provided with both a Public Key and a Secret Key.

Connector Setup

The Connector now can be installed using the credentials obtained in the above steps:

Client ID: Public key

Secret: Secret Key

You will also need to add the subdomain of your application to the connector when initialising it. If your URL is '' you would fill the field with 'app'.

You will then be prompted to log in, select your CandidateHub account information and authorize access to the connector.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.