Submitting a candidate

When you identify a job posting you are interested in, use the API to submit candidates to that posting.

To interact with the candidate APIs, you must use a valid access token. For more information, see Security and authentication.

Selecting a worker from your talent pool

Before submitting a candidate, create or select the worker profile you want to use for the submission. The worker profile entity contains information relating to the individual that doesn’t relate specifically to this job posting, such as personal information and contact details.

Use the Worker APIs to manage your workers.

Preparing the submission

When you’ve identified a posting and a worker, use the Create Candidate API to create a candidate entity. This candidate will have a CREATED status, which means it can still be edited before submitting it to the client.

Client-specific custom fields

Each client will have different configuration and required fields as requirements for submitting a candidate. Use the Candidate Metadata API to fetch information about the custom fields that are available for this particular posting, and whether they are required or not.

Adding a resume

To add a resume to the candidate submission, use the Add Media API.

Submitting the candidate

When your submission is ready, use the Submit Candidate API to submit your candidate. The candidate status will change to SUBMITTING, and the candidate submission will be sent to the client VMS.

Next, the client VMS will process the candidate submission. If this is successful, the status will change to SUBMITTED, and the candidate will be available in the client VMS for the selection process to begin. If there is an issue processing the candidate, the status will change to SUBMISSION_FAILED and a detailed error message will be available via the submissionErrorMessage field.

Future enhancements

The Supplier Network team is continuously committed to enhance the application’s value by building new features and integrations. To keep track of all enhancements the team is working on, visit Productboard.

Monitoring the candidate post-submission: An important part of integration is monitoring the candidate through the selection process in the client VMS. We are currently working on reflecting these updates via the API.

Notifications: We plan on making webhook notifications available for important events in the candidate lifecycle, similar to the ones that are already available for job postings.