Manatal

Create a new employer by name. If an employer with this name already exists, it will be linked. The response contains an `employer` field — that is the usable employer ID for downstream calls.

create_employer

Create a new job.

create_job

Create a new organization. Note: there is no dedupe-by-name on this endpoint, so repeated calls with the same name will create distinct organization records.

create_organization

Create a new position/job title by name. If a position with this name already exists, it will be linked. The response contains a `position` field — that is the usable position ID for downstream calls.

create_position

Create a new school/university by name. If a school with this name already exists, it will be linked. The response contains a `school` field — that is the usable school ID for downstream calls.

create_school

Get a candidate's full profile by ID.

get_candidate

List the candidate field definitions configured by this client, grouped the way they appear on the candidate profile. Call this before writing `custom_field_input` in `create_candidate` or `update_candidate`: it is the only source of valid field slugs and of the allowed values for choice fields. Use it whenever the user refers to a field by its display name (e.g. "set her seniority to Senior") so the name can be resolved to the exact `slug` and the value checked against `answer_choices`. The definitions are the same for every candidate of the client, so call this once per conversation and reuse the result.

get_candidate_field

Read a candidate's resumes. Use resume_parsed_edited from the default resume to read and summarize the CV. Check state before using the parsed content: it may be processing, completed, or failed. Do not try to download resume file URLs. Example: "Read Emma's CV and tell me how well she fits this job description."

get_candidate_resume

Get a job's full details by ID.

get_job

Return the kanban layout (pipeline stages) for a job, including stage name, category, key stages, and automation flags. Use each stage's `id` as `job_pipeline_stage_id` for `bulk_move_matches`, and as `stage_id` for `list_drop_candidates`.

get_job_match_stage

Get a match's full details by ID, including pipeline stage, scores, and activity counts.

get_match

Get a single meeting of AI Interviewer or AI Notetaker by ID, including transcript and assessment JSON.

get_meeting

List all education entries for a candidate.

list_candidate_educations

List all work experience entries for a candidate.

list_candidate_experiences

List meetings of AI Interviewer and AI Notetaker for a candidate, including assessment JSON. Use to review interview/notetaker content for this candidate. Each page is capped at 10 meetings because assessments are large.

list_candidate_meetings

List all notes for a candidate.

list_candidate_notes

List confirmed social profiles for a candidate. Results are limited by the backend to profiles with confidence_level at least 0.7 that have not been marked incorrect.

list_candidate_social_media

List available candidate tags for the authenticated client. Use the returned `id` values with the `tags__in` filter when searching candidates by tag.

list_candidate_tags

List meetings of AI Notetaker for a contact, including assessment JSON. Use to review interview/notetaker content for this contact. Each page is capped at 10 meetings because assessments are large.

list_contact_meetings

List all notes for a contact.

list_contact_notes

List the client's match drop reasons. Use the returned `id` values as `drop_reason_id_list` when calling `bulk_drop_matches`.

list_drop_reasons

Return a paginated list of dropped (inactive) candidates for a job kanban stage. `stage_id` is required and must be a job pipeline stage id from `get_job_match_stage`.

list_drop_candidates

List available industries for the authenticated client. Use the returned `id` values with the `industries__in` or `industries__contain` filters when searching candidates by industry.

list_industries

List meetings of AI Interviewer for a job, including assessment JSON. Use to review interview/notetaker content for candidates on this job. Each page is capped at 10 meetings because assessments are large.

list_job_meetings

List all notes for a job.

list_job_notes

List the client's match stage catalog (e.g. Applied, Interview, Offered, Hired). Returned ids are what the `job_pipeline_stage__match_stage__in` filter expects when searching matches.

list_match_stages

List all notes for an organization.

list_organization_notes

Search candidates by name, email, phone number, position, company, source type, creator, and owner.

search_candidates

Search contacts by name, display name, email, phone, organization, type, location, and creation date.

search_contacts

Search degrees by name to look up degree IDs for candidate education entries. Results are ordered by rank.

search_degrees

Search employers by name to look up employer IDs for candidate experience entries.

search_employers

Search jobs by position, organization, status, owner, and other filters.

search_jobs

Search matches (candidate-job pairings) by pipeline stage and date ranges.

search_matches

Search organizations (companies/clients) by name, location, owner, and other filters.

search_organizations

Search positions/job titles by name to look up position IDs for candidate experience entries.

search_positions

Search schools/universities by name to look up school IDs for candidate education entries. Requires at least 3 characters. Returns max 10 results.

search_schools

Partially update a candidate profile. The path id must be the candidate primary key (for match results, use candidate_id, not the match id). Only supplied fields are changed.

update_candidate