Integrating your existing tech recruiting tools can help your team save time, improve the speed of information transfer from Recruiters to Hiring Managers, and ensure your knowledge management is working effectively.
If you haven't already, read our API Documentation to understand how the API works and what functionality it provides.
Once you know you want to create an integration, you'll first need to register your application with us to get your API credentials.
Custom integrations
To create a Custom integration, go to:
Apps & Integrations → Custom Integrations → Create App
After entering the application name and clicking Create, you will be given the API key and OAuth credentials that you can use in your application. You will also be able to configure OAuth redirection URIs.
Rotating credentials for a custom application
For custom applications, credentials can be rotated using Reset Credentials.
Resetting credentials replaces the existing credentials with newly generated ones. Make sure the application using the old credentials is updated with the new values.
Integration user
If you don't want to assign your integration to a specific user from your company, you can create an integration user.
An integration user cannot be used to log in to Codility, but its API credentials can be used by third-party tools, integrations, or API clients.
An integration user can be created and managed by an account Administrator only.
To create one, go to:
Apps & Integrations → Custom Integrations → Create Integration User
You will need to provide:
- Email – the email associated with the integration user.
- Application name – the name of the application initially associated with this user.
How to get the keys of an integration user
Go to the integrations page and open Custom Integrations.
The integration user will appear there together with its applications and credentials. Account Administrators can manage the applications and their API and OAuth credentials from this view.
Rotating API keys for an integration user
Note: Only account Administrators can add or revoke API keys for an integration user.
Integration users support an easier and safer way of rotating API keys.
Instead of resetting the existing credentials, use Add key to create a new API key.
This allows you to:
- Add a new key while the existing key is still available.
- Update the external integration or API client to use the new key.
- Verify that the new key works correctly.
- Revoke the old key once it is no longer being used.
This avoids having to replace the active key immediately and makes key rotation possible without interruption to the integration.
OAuth redirection URIs can also be managed in the same view.
If you have any more questions about Codility's API or what information you can retrieve from it, please contact support@codility.com.