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

ActionWhat it does
Create prehireAdd 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 applicationsFind applications by one of: a job posting, the dates applicants were placed on an eligible list, or the dates postings closed.
Find employee by usernameGet the employee ID and user ID that go with a NEOGOV username, for 'Start onboarding'.
Find employees by dateFind the employees added, or changed, in Perform between two dates.
Get agency-wide answersGet the applicant's answers to the agency-wide questions on an application.
Get applicationGet an application: the applicant's details, education, work history and skills.
Get employeeGet an employee by NEOGOV ID or employee number, with position, department and manager.
Get hireGet a hire: start and orientation dates, offer, approval and the application it came from.
Get job postingGet a job posting with its description, qualifications, salary and dates.
Get requisitionGet a requisition: its title, status, class, department and vacancies.
List departmentsList the agency's departments.
List divisionsList the agency's divisions, with the department each is in.
List employeesList the agency's employees in Perform, a page at a time.
List job postingsList the agency's job postings in Insight, a page at a time.
List recent hiresList the hires made in Insight since a date (and until one), a page at a time.
Set employee statusMake an employee active or inactive in Perform, cancelling their open evaluations if asked.
Start onboardingStart 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

EmailemailtextRequired
The new hire's email address.
First namefirst_nametextRequired
The new hire's first name.
Last namelast_nametextRequired
The new hire's last name.
Start dateexpected_start_datedateRequired
The day they start.
Usernameusernametext
Their NEOGOV username. Leave empty to use the email address.
Middle namemiddle_nametext
The new hire's middle name.
Phonephonetext
Their phone number.
Street addressaddresstext
Their street address.
Citycitytext
Their city.
Statestatetext
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 codezip_codetext
Their ZIP or postal code.
Departmentdepartmenttext
Their department.
Divisiondivisiontext
Their division.
Position IDposition_idtext
Their position's NEOGOV ID, such as an employee's position ID.
Statusstatustext
Prehire, or Authorized prehire. Defaults to Prehire.One of: 0 (Prehire), 1 (Authorized prehire). Default: 0.
Send activation emailsend_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 postingjob_posting_numbertext
Applications to this job posting. Pick one, or type its job number.
Eligible on or aftereligible_afterdate
Applicants placed on an eligible list on or after this date.
Eligible on or beforeeligible_beforedate
Applicants placed on an eligible list on or before this date.
Posting closed on or afterclosing_afterdate
Applications to postings that closed on or after this date.
Posting closed on or beforeclosing_beforedate
Applications to postings that closed on or before this date.
How manylimitnumber
How many applications to return, 1 to 500. Defaults to 50.From 1 to 500.
Skipskipnumber
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

UsernameusernametextRequired
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

Employeesdate_fieldtext
Those added, or those changed. Defaults to added.One of: created (Added), updated (Changed). Default: created.
Fromsincedate
On or after this date.
Tountildate
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

ApplicationapplicationtextRequired
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

ApplicationapplicationtextRequired
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

EmployeeemployeetextRequired
The employee's NEOGOV ID, or employee number when 'Find by' says so.
Find byfind_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

HirehiretextRequired
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 postingjob_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

RequisitionrequisitiontextRequired
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

Pagepagenumber
Which page to return, from 1. Use the next page when 'has_more' is true.At least 1.
Page sizeper_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

Pagepagenumber
Which page to return, from 1. Use the next page when 'has_more' is true.At least 1.
Page sizeper_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

Sincesincedate and timeRequired
Hires made since this time.
Untiluntildate and time
Hires made until this time. Leave empty for up to now.
Pagepagenumber
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

EmployeeemployeetextRequired
The employee's NEOGOV ID, usually from an earlier step.
Activeactivetrue/falseRequired
On to make the employee active, off to make them inactive.
Cancel their evaluationscancel_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

Employeeemployee_idtextRequired
The employee ID, from 'Create prehire' or 'Find employee by username'.
Assign checklistsassign_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
}

On this page