NEOGOV
App · 17 actions
Read NEOGOV job postings, applications and hires, look up employees, departments and divisions, add new hires to Onboard and start their onboarding, and start workflows when postings go up, applications arrive or hires are made.
Actions
| Action | What it does |
|---|---|
| Create prehire | Add a new hire to Onboard as a prehire, with their start date, department, division and position, and send them an activation email if asked. |
| Find applications | Find applications by one of: a job posting, the dates applicants were placed on an eligible list, or the dates postings closed. |
| Find employee by username | Get the employee ID and user ID that go with a NEOGOV username, for 'Start onboarding'. |
| Find employees by date | Find the employees added, or changed, in Perform between two dates. |
| Get agency-wide answers | Get the applicant's answers to the agency-wide questions on an application. |
| Get application | Get an application: the applicant's details, education, work history and skills. |
| Get employee | Get an employee by NEOGOV ID or employee number, with position, department and manager. |
| Get hire | Get a hire: start and orientation dates, offer, approval and the application it came from. |
| Get job posting | Get a job posting with its description, qualifications, salary and dates. |
| Get requisition | Get a requisition: its title, status, class, department and vacancies. |
| List departments | List the agency's departments. |
| List divisions | List the agency's divisions, with the department each is in. |
| List employees | List the agency's employees in Perform, a page at a time. |
| List job postings | List the agency's job postings in Insight, a page at a time. |
| List recent hires | List the hires made in Insight since a date (and until one), a page at a time. |
| Set employee status | Make an employee active or inactive in Perform, cancelling their open evaluations if asked. |
| Start onboarding | Start onboarding for an employee or prehire, assigning their onboarding checklists. |
Create prehire
Add a new hire to Onboard as a prehire, with their start date, department, division and position, and send them an activation email if asked.
Inputs
- Email
emailtextRequired - The new hire's email address.
- First name
first_nametextRequired - The new hire's first name.
- Last name
last_nametextRequired - The new hire's last name.
- Start date
expected_start_datedateRequired - The day they start.
- Username
usernametext - Their NEOGOV username. Leave empty to use the email address.
- Middle name
middle_nametext - The new hire's middle name.
- Phone
phonetext - Their phone number.
- Street address
addresstext - Their street address.
- City
citytext - Their city.
- State
statetext - Their state or province.One of:
1(Alabama),2(Alaska),3(Arizona),4(Arkansas),5(California),6(Colorado),7(Connecticut),8(Delaware),9(District of Columbia),10(Florida), and 66 more. - ZIP code
zip_codetext - Their ZIP or postal code.
- Department
departmenttext - Their department.
- Division
divisiontext - Their division.
- Position ID
position_idtext - Their position's NEOGOV ID, such as an employee's position ID.
- Status
statustext - Prehire, or Authorized prehire. Defaults to Prehire.One of:
0(Prehire),1(Authorized prehire). Default:0. - Send activation email
send_activationtrue/false - Email the new hire a link to activate their NEOGOV account.Default:
false.
Outputs
emailtext- Their email address
employee_idtext- The prehire's employee ID
user_idtext- The prehire's user ID
usernametext- Their NEOGOV username
Example output
{
"email": "mary.smith@example.gov",
"employee_id": "f572f9b11ec166df3dd04d23e4f6d485",
"user_id": "149430d2bf433fa1ac5b8809651e0e8d",
"username": "mary.smith@example.gov"
}Find applications
Find applications by one of: a job posting, the dates applicants were placed on an eligible list, or the dates postings closed.
Inputs
- Job posting
job_posting_numbertext - Applications to this job posting. Pick one, or type its job number.
- Eligible on or after
eligible_afterdate - Applicants placed on an eligible list on or after this date.
- Eligible on or before
eligible_beforedate - Applicants placed on an eligible list on or before this date.
- Posting closed on or after
closing_afterdate - Applications to postings that closed on or after this date.
- Posting closed on or before
closing_beforedate - Applications to postings that closed on or before this date.
- How many
limitnumber - How many applications to return, 1 to 500. Defaults to 50.From 1 to 500.
- Skip
skipnumber - How many to skip, such as 'next_skip' from an earlier step.At least 0.
Outputs
applicationslist- The applications
countnumber- How many were returned
filtertext- The search, as sent to NEOGOV
next_skipnumber- The 'Skip' for the next batch, empty on the last
Example output
{
"applications": [
{
"application_id": "9114dc99d78dc1a0404fea873f31e77e4753067166a5e3bf",
"exam_type": "Open",
"first_name": "Mary",
"last_name": "Smith",
"middle_name": "Pauline",
"person_id": "1165361"
}
],
"count": 1,
"filter": "jobpostingnumber eq '2026-0412'",
"next_skip": null
}Find employee by username
Get the employee ID and user ID that go with a NEOGOV username, for 'Start onboarding'.
Inputs
- Username
usernametextRequired - The person's NEOGOV username, often their email address.
Outputs
employee_idtext- The employee's ID
user_idtext- The user's ID
usernametext- The username, as given
Example output
{
"employee_id": "f572f9b11ec166df3dd04d23e4f6d485",
"user_id": "149430d2bf433fa1ac5b8809651e0e8d",
"username": "mary.smith@example.gov"
}Find employees by date
Find the employees added, or changed, in Perform between two dates.
Inputs
- Employees
date_fieldtext - Those added, or those changed. Defaults to added.One of:
created(Added),updated(Changed). Default:created. - From
sincedate - On or after this date.
- To
untildate - On or before this date.
Outputs
countnumber- How many were returned
employeeslist- The employees
Example output
{
"count": 1,
"employees": [
{
"active": true,
"created_at": "2026-11-16T07:56:54",
"department": "City Clerk",
"division": "Records",
"email": "mary.smith@example.gov",
"employee_number": "1212123",
"first_name": "Mary",
"hire_date": null,
"id": "0123456789abcdef0123456789abcdef",
"last_name": "Smith",
"manager": "Alex Rivera",
"position": "Deputy City Clerk",
"start_date": "2026-11-16T00:00:00",
"updated_at": "2026-11-16T07:56:54",
"username": "mary.smith@example.gov"
}
]
}Get agency-wide answers
Get the applicant's answers to the agency-wide questions on an application.
Inputs
- Application
applicationtextRequired - The application's ID, from 'Find applications', a hire or a trigger.
Outputs
answerslist- Each question and its answers
application_idtext- The application's ID
countnumber- How many were returned
questionsobject- NEOGOV's own answer
Example output
{
"answers": [
{
"answers": [
"No"
],
"question": "Have you worked for this agency before?"
}
],
"application_id": "9114dc99d78dc1a0404fea873f31e77e4753067166a5e3bf",
"count": 1,
"questions": {}
}Get application
Get an application: the applicant's details, education, work history and skills.
Inputs
- Application
applicationtextRequired - The application's ID, from 'Find applications', a hire or a trigger.
Outputs
applicationobject- The application as NEOGOV holds it
summaryobject- The application, in short
Example output
{
"application": {
"applicationfinfo": {
"classification": "Deputy City Clerk",
"datereceived": "10/28/2026 11:07:00",
"email": "mary.smith@example.com",
"firstname": "Mary",
"id": "9114dc99d78dc1a0404fea873f31e77e4753067166a5e3bf",
"jobpostingurl": "https://api.neogov.com/rest/jobpostings/56789abcdef0123456789abcdef01234",
"lastname": "Smith"
},
"educationhistory": [
{
"degree": "Bachelor's",
"graduate": "True",
"major": "Public Administration",
"schoolname": "Sacramento State"
}
],
"skills": [
{
"skilllevel": "Skilled",
"skillname": "Laserfiche",
"yearsofexperience": "4"
}
],
"workhistory": [
{
"companyname": "County of Yolo",
"endyear": "2026",
"positiontitle": "Records Clerk",
"startyear": "2020"
}
]
},
"summary": {
"application_id": "9114dc99d78dc1a0404fea873f31e77e4753067166a5e3bf",
"city": "Sacramento",
"email": "mary.smith@example.com",
"first_name": "Mary",
"job_posting_id": "56789abcdef0123456789abcdef01234",
"job_title": "Deputy City Clerk",
"last_name": "Smith",
"received_at": "2026-10-28T11:07:00",
"state": "CA"
}
}Get employee
Get an employee by NEOGOV ID or employee number, with position, department and manager.
Inputs
- Employee
employeetextRequired - The employee's NEOGOV ID, or employee number when 'Find by' says so.
- Find by
find_bytext - Whether 'Employee' is the NEOGOV ID or the employee number.One of:
id(NEOGOV employee ID),employeenumber(Employee number). Default:id.
Outputs
employeeobject- The employee as NEOGOV holds it
summaryobject- An employee
Example output
{
"employee": {
"active": "True",
"createddate": "11/16/2026 7:56:54 AM",
"department": {
"id": "0123456789abcdef0123456789abcdef",
"name": "City Clerk"
},
"directmanager": {
"fullname": "Alex Rivera",
"id": "89abcdef0123456789abcdef01234567"
},
"division": {
"id": "cdef0123456789abcdef0123456789ab",
"name": "Records"
},
"email": "mary.smith@example.gov",
"employeenumber": "1212123",
"firstname": "Mary",
"id": "0123456789abcdef0123456789abcdef",
"lastname": "Smith",
"phone": "555-222-3333",
"position": {
"id": "23456789abcdef0123456789abcdef01",
"title": "Deputy City Clerk"
},
"updateddate": "11/16/2026 7:56:54 AM",
"user": {
"id": "6789abcdef0123456789abcdef012345",
"username": "mary.smith@example.gov"
}
},
"summary": {
"active": true,
"created_at": "2026-11-16T07:56:54",
"department": "City Clerk",
"division": "Records",
"email": "mary.smith@example.gov",
"employee_number": "1212123",
"first_name": "Mary",
"hire_date": null,
"id": "0123456789abcdef0123456789abcdef",
"last_name": "Smith",
"manager": "Alex Rivera",
"position": "Deputy City Clerk",
"start_date": "2026-11-16T00:00:00",
"updated_at": "2026-11-16T07:56:54",
"username": "mary.smith@example.gov"
}
}Get hire
Get a hire: start and orientation dates, offer, approval and the application it came from.
Inputs
- Hire
hiretextRequired - The hire's ID, from 'List recent hires' or the New hire trigger.
Outputs
hireobject- The hire (personnel action) as NEOGOV holds it
summaryobject- The hire, in short
Example output
{
"hire": {
"applicationinfourl": "https://api.neogov.com/rest/applications/9114dc99d78dc1a0404fea873f31e77e4753067166a5e3bf",
"authorizeddate": "2026-10-30T21:24:10.407Z",
"dthirestart": "11/16/2026 08:00:00",
"id": "23456789abcdef0123456789abcdef0123456789abcdef01",
"isapproved": "Active",
"jobpostingurl": "https://api.neogov.com/rest/jobpostings/56789abcdef0123456789abcdef01234",
"offeramount": "72000",
"personid": "10591789",
"requisitionurl": "https://api.neogov.com/rest/requisitions/123456789abcdef0123456789abcdef0",
"status": "Active"
},
"summary": {
"application_id": "9114dc99d78dc1a0404fea873f31e77e4753067166a5e3bf",
"approved": true,
"authorized_at": "2026-10-30T21:24:10Z",
"employee_url": "https://api.neogov.com/rest/employees/employeenumber/0038",
"hire_id": "23456789abcdef0123456789abcdef0123456789abcdef01",
"job_posting_id": "56789abcdef0123456789abcdef01234",
"offer_amount": "72000",
"offer_date": "2026-10-30T14:00:00",
"orientation_date": "2026-11-16T09:00:00",
"person_id": "10591789",
"processed_by": "Jordan Lee",
"requisition_id": "123456789abcdef0123456789abcdef0",
"start_date": "2026-11-16T08:00:00",
"status": "Active"
}
}Get job posting
Get a job posting with its description, qualifications, salary and dates.
Inputs
- Job posting
job_postingtextRequired - The job posting. Pick one, or give its ID from an earlier step.
Outputs
job_postingobject- The job posting as NEOGOV holds it
summaryobject- A job posting
Example output
{
"job_posting": {
"advfrom": "10/20/2026 08:00:00",
"advto": "11/20/2026 17:00:00",
"classification": "Deputy City Clerk",
"closed": "Inactive",
"departmenturl": "https://api.neogov.com/rest/departments/789abcdef0123456789abcdef0123456",
"draft": "Inactive",
"examplesofduties": "Prepares agendas and minutes.",
"fulldescription": "Supports the City Clerk with records and elections.",
"id": "56789abcdef0123456789abcdef01234",
"jobnumber": "2026-0412",
"jobtype": "Full-Time",
"qualifications": "Two years of records experience.",
"salarymax": "84000.00",
"salarymin": "68000.00",
"url": "https://api.neogov.com/rest/jobpostings/56789abcdef0123456789abcdef01234"
},
"summary": {
"categories": [
"Administration"
],
"department_id": "789abcdef0123456789abcdef0123456",
"exam_type": "Open",
"id": "56789abcdef0123456789abcdef01234",
"is_draft": false,
"is_open": true,
"job_number": "2026-0412",
"job_type": "Full-Time",
"location": "City Hall",
"locations": [
"CA-Sacramento"
],
"posted_from": "2026-10-20T08:00:00",
"posted_to": "2026-11-20T17:00:00",
"salary_max": "84000.00",
"salary_min": "68000.00",
"title": "Deputy City Clerk"
}
}Get requisition
Get a requisition: its title, status, class, department and vacancies.
Inputs
- Requisition
requisitiontextRequired - The requisition's ID, such as a hire's 'requisition_id'.
Outputs
requisitionobject- The requisition as NEOGOV holds it
summaryobject- The requisition, in short
Example output
{
"requisition": {
"classtitle": "Deputy City Clerk",
"datecreated": "09/01/2026 19:47:18",
"departmentcode": "CLK",
"desiredstartdate": "11/16/2026",
"id": "123456789abcdef0123456789abcdef0",
"requisitionnumber": "200399",
"requisitiontitle": "Deputy City Clerk",
"status": "Approved",
"vacancies": "1"
},
"summary": {
"class_title": "Deputy City Clerk",
"created_at": "2026-09-01T19:47:18",
"department_code": "CLK",
"id": "123456789abcdef0123456789abcdef0",
"number": "200399",
"status": "Approved",
"title": "Deputy City Clerk",
"vacancies": "1"
}
}List departments
List the agency's departments.
Inputs
None.
Outputs
countnumber- How many were returned
departmentslist- The departments
Example output
{
"count": 1,
"departments": [
{
"active": true,
"code": "CLK",
"department": null,
"id": "f0123456789abcdef0123456789abcde",
"name": "City Clerk"
}
]
}List divisions
List the agency's divisions, with the department each is in.
Inputs
None.
Outputs
countnumber- How many were returned
divisionslist- The divisions
Example output
{
"count": 1,
"divisions": [
{
"active": true,
"code": "REC",
"department": "City Clerk",
"id": "cdef0123456789abcdef0123456789ab",
"name": "Records"
}
]
}List employees
List the agency's employees in Perform, a page at a time.
Inputs
- Page
pagenumber - Which page to return, from 1. Use the next page when 'has_more' is true.At least 1.
- Page size
per_pagenumber - How many to return per page, 1 to 500. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many were returned
employeeslist- The employees
has_moretrue/false- Whether there may be a next page
pagenumber- The page returned
Example output
{
"count": 1,
"employees": [
{
"active": true,
"created_at": "2026-11-16T07:56:54",
"department": "City Clerk",
"division": "Records",
"email": "mary.smith@example.gov",
"employee_number": "1212123",
"first_name": "Mary",
"hire_date": null,
"id": "0123456789abcdef0123456789abcdef",
"last_name": "Smith",
"manager": "Alex Rivera",
"position": "Deputy City Clerk",
"start_date": "2026-11-16T00:00:00",
"updated_at": "2026-11-16T07:56:54",
"username": "mary.smith@example.gov"
}
],
"has_more": false,
"page": 1
}List job postings
List the agency's job postings in Insight, a page at a time.
Inputs
- Page
pagenumber - Which page to return, from 1. Use the next page when 'has_more' is true.At least 1.
- Page size
per_pagenumber - How many to return per page, 1 to 500. Defaults to 50.From 1 to 500.
Outputs
countnumber- How many were returned
has_moretrue/false- Whether there may be a next page
job_postingslist- The job postings
pagenumber- The page returned
Example output
{
"count": 1,
"has_more": false,
"job_postings": [
{
"categories": [
"Administration"
],
"department_id": "789abcdef0123456789abcdef0123456",
"exam_type": "Open",
"id": "56789abcdef0123456789abcdef01234",
"is_draft": false,
"is_open": true,
"job_number": "2026-0412",
"job_type": "Full-Time",
"location": "City Hall",
"locations": [
"CA-Sacramento"
],
"posted_from": "2026-10-20T08:00:00",
"posted_to": "2026-11-20T17:00:00",
"salary_max": "84000.00",
"salary_min": "68000.00",
"title": "Deputy City Clerk"
}
],
"page": 1
}List recent hires
List the hires made in Insight since a date (and until one), a page at a time.
Inputs
- Since
sincedate and timeRequired - Hires made since this time.
- Until
untildate and time - Hires made until this time. Leave empty for up to now.
- Page
pagenumber - Which page to return, from 1. Use the next page when 'has_more' is true.At least 1.
Outputs
countnumber- How many were returned
hireslist- The hires
pagenumber- The page returned
Example output
{
"count": 1,
"hires": [
{
"authorized_at": "2026-10-30T21:24:10Z",
"created_at": "2026-10-30T13:17:56",
"hire_id": "23456789abcdef0123456789abcdef0123456789abcdef01"
}
],
"page": 1
}Set employee status
Make an employee active or inactive in Perform, cancelling their open evaluations if asked.
Inputs
- Employee
employeetextRequired - The employee's NEOGOV ID, usually from an earlier step.
- Active
activetrue/falseRequired - On to make the employee active, off to make them inactive.
- Cancel their evaluations
cancel_evaluationstrue/false - Also set the employee's evaluations to Cancelled.Default:
false.
Outputs
activetrue/false- Whether they are now active
cancelled_evaluationslist- Evaluations cancelled
employee_idtext- The employee's ID
Example output
{
"active": false,
"cancelled_evaluations": [
"8f774b941635facee4d00ed0ae412cfc"
],
"employee_id": "0123456789abcdef0123456789abcdef"
}Start onboarding
Start onboarding for an employee or prehire, assigning their onboarding checklists.
Inputs
- Employee
employee_idtextRequired - The employee ID, from 'Create prehire' or 'Find employee by username'.
- Assign checklists
assign_checkliststrue/false - Assign the onboarding checklists. On unless turned off.Default:
true.
Outputs
checklists_assignedtrue/false- Whether checklists were asked for
employee_idtext- The employee's ID
startedtrue/false- True once onboarding started
Example output
{
"checklists_assigned": true,
"employee_id": "f572f9b11ec166df3dd04d23e4f6d485",
"started": true
}