API Reference
Subscribe to UpdatesHelp CenterComeet
Start typing to search…

Changelog

Aug 20, 2025

  • Candidates
    • Add a File – New endpoint introduced to upload a file to an existing candidate. Supports single-file upload per request.
    • Add a Resume – New endpoint added to upload a resume to an existing candidate, supports single-file upload per call.
    • Retrieve Candidate Files – New endpoint to retrieve the list of files attached to a candidate.

  • Feb 6, 2025

  • Position Schema - url_comeet_hosted_page field was changed to url_recruit_hosted_page.
    • url_comeet_hosted_page will be deprecated soon.

October 8, 2024

  • List All Candidates - new filter deleted was added.

July 11, 2024

  • List All Positions - new filter is_template was added.
  • List All Questionnaires - the new Questionnaires endpoint allows to read company questionnaires, permission is required.
  • Create a Position - position questionnaire_uids array was added to the endpoint, allowing questionnaires to be attached to positions.
  • Clone a position - the new Clone a position endpoint allows the cloning of a position from a position template.

Dec 21, 2023

Create a Position - position salary_range object was added.

Nov 30, 2023

  • Retrieve an opening - the hired_candidate_time_applied time_applied, hired_candidate_start_date and hired_candidate_hire_date, were added to the Retrieve an Opening endpoint.

Nov 16, 2023

  • List of Positions - query string parameter is_discreet added to the list position endpoint.
  • Position model - position salary_range object was added to the endpoint.
  • Candidate model - position salary_expectations field was added to the endpoint.

Oct 12, 2023

  • Create a Position - added the allow_fallback property to enable the creation of a position when the email addresses of the lead recruiter or hiring manager do not match an existing user in Comeet.

Sep 28, 2023

  • Position Updates Webhook - Comeet offers webhook functionality for position events, enabling partners to configure webhooks to receive direct notifications and data payloads for events such as position creation, update, and deletion. This feature facilitates the synchronization process, allowing for an efficient and automated update flow within external systems.

Sep 22, 2023

  • Create a Position - the new Create a Position endpoint allows to create a new position along with new openings for the position.
  • Create an Opening - the new Create an Opening endpoint allows to create a new opening for an existing position.
  • List All Locations - the new List All Locations endpoint allows to retrieve the details of the locations. See the Location Model for reference.

July 23, 2023

June 28, 2023

  • ​On July 5, 2023 Comeet will be deprecating support for the following TLS 1.2 Cipher Suites, due to known vulnerabilities. If you are still using any of the Cipher suites below, please update your code, libraries, or infrastructure to use a more updated version:
    TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 (0xc027) ECDH x25519 (eq. 3072 bits RSA) FS TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 (0xc028) ECDH x25519 (eq. 3072 bits RSA) FS TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA (0xc013) ECDH x25519 (eq. 3072 bits RSA) FS TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA (0xc014) ECDH x25519 (eq. 3072 bits RSA) FS TLS_RSA_WITH_AES_128_GCM_SHA256 (0x9c) TLS_RSA_WITH_AES_256_GCM_SHA384 (0x9d) TLS_RSA_WITH_AES_128_CBC_SHA256 (0x3c) TLS_RSA_WITH_AES_256_CBC_SHA256 (0x3d) TLS_RSA_WITH_AES_128_CBC_SHA (0x2f) TLS_RSA_WITH_AES_256_CBC_SHA (0x35) TLS_RSA_WITH_CAMELLIA_256_CBC_SHA (0x84) TLS_RSA_WITH_CAMELLIA_128_CBC_SHA (0x41)

Mar 29, 2023

  • List All Openings - the new List All Openings endpoint allows to retrieve all openings or a group of openings by using filters.
  • Retrieve an Opening - the new Retrieve an Opening endpoint allows to retrieve an opening object by UID.

Feb 27, 2023

  • Candidate model - the opening object is now included with the candidate object when the candidate's status is Hired.

Feb 20, 2023

  • Position model - the value of workplace_type is now included in the categories array of the position object. This property supports the values: On-site, Hybrid and Remote.

Dec 8, 2022

  • Position model - the new property is_talent_pool was added to the position object to indicate whether a position is a talent pool, as opposed to an active position.

Mar 8, 2022

  • Position model - the details of the hiring manager, lead recruiter and lead recruiting coordinator can now be added to the position object. Receiving these details requires a special permission.
  • Source object - the source object in the candidate model has been updated and now includes the type as a string (instead of an enumeration) and the name of the source.

Dec 15, 2021

  • New API name – We’ve changed the name of Sourcing API to Recruiting API to reflect the expanding needs this API now serves.
  • Conversations – We’ve added new endpoints that allow you to make conversations happening outside of Comeet visible in candidates’ profiles: Create a conversation, Create a message, Update message status. This makes it easier to keep everyone in the hiring process on the same page.
  • Notes – You can now create a note on a candidate’s profile to reflect information about the candidate or an activity that took place outside of Comeet: Create a candidate note.
  • Update candidate details – We’ve added an endpoint that allows you to update the candidate’s details: Update a candidate.
  • Candidate’s source – We’ve added the source and source contact to the candidate object. Receiving these details requires a dedicated permission.
  • Position URL – We’ve added to the position object the URL to the position’s page in Comeet. You can now link from your app to the candidates profiles and positions pages in Comeet.
  • Retrieve a candidate using an ID – you can now request a candidate object using the candidate ID that is used in the candidate’s URL in Comeet. See this option here.
  • Candidate model - step objects in the current_steps and completed_steps array now include the position_step_uid which references the position step from which the candidate step was inherited.