Lodol Docs

ZipRecruiter

API actions for the ZipRecruiter integration.

ZipRecruiter

Manage ZipRecruiter jobs and applications from Lodol.


Add application note

Attach an internal note to a ZipRecruiter application for collaboration.

Parameters

ParameterTypeRequiredDescription
application_idstringNoID of the application receiving the note.
notestringNoNote content to attach to the application.

Response

{
  "note": "mock_value",
  "note_id": "mock_value",
  "status": "mock_value"
}

Post job

Create and publish a new job posting with title, description, company, and location.

Parameters

ParameterTypeRequiredDescription
titlestringNoTitle of the job posting.
descriptionstringNoFull description of the job responsibilities and requirements.
companystringNoCompany name for the posting.
locationstringNoLocation of the role (city, state, or remote).

Response

{
  "job_id": "mock_value",
  "location": "mock_value",
  "status": "mock_value",
  "title": "mock_value"
}

Search jobs

Search ZipRecruiter job listings by keyword with optional location filters.

Parameters

ParameterTypeRequiredDescription
querystringNoSearch phrase for job titles and descriptions.
locationstringNoOptional location filter (city, state, or remote).
pagenumberNoPage number of results to fetch (defaults to 1).
per_pagenumberNoNumber of jobs per page (defaults to 20).

Response

{
  "jobs": [
    {}
  ],
  "status": "mock_value"
}

Submit application

Submit a candidate application to a specific ZipRecruiter job posting.

Parameters

ParameterTypeRequiredDescription
job_idstringNoIdentifier of the job to apply for.
candidate_namestringNoFull name of the applicant.
candidate_emailstringNoEmail address of the applicant.
resume_urlstringNoOptional URL to the candidate's resume.

Response

{
  "application_id": "mock_value",
  "job_id": {},
  "status": "mock_value"
}

Update application status

Update the status of a submitted ZipRecruiter application.

Parameters

ParameterTypeRequiredDescription
application_idstringNoID of the application to update.
statusstringNoNew status for the application (e.g., reviewing, interview, rejected).

Response

{
  "application_id": "mock_value",
  "status": "mock_value"
}

On this page