---
title: "Create Job Code"
method: POST
path: "/apiHub/payroll/v1/companies/{companyId}/jobs"
tags: ["Job Codes"]
---

# Create Job Code

`POST /apiHub/payroll/v1/companies/{companyId}/jobs`

## Request

- Base URL: `dc1demogwext.paylocity.com` (relative, and the document’s source URL is not known)
- URL: `dc1demogwext.paylocity.com/apiHub/payroll/v1/companies/{companyId}/jobs`
- Auth: none declared

**Summary Description**

The POST Single Job Code endpoint enables users to create precise values regarding Job Codes from the Paylocity instance of a client. In order to utilize this endpoint, it is necessary to provide the payload values in accordance with the established standards of the Paylocity API, as specified for the respective object type and description. It is required to provide the Company ID in the endpoint and the specifications of the Job Code in the payload body

**Use Cases**

- This API endpoint will allow an API user to create a Job Code record for a specific company ID
- Job Codes must be added before running payroll

## Path parameters

- `companyId` string, required

## Headers

- `Authorization` string

## Request body

- CreateJobCodeDto: Job Details
  - `code` string, required: A Job Code may contain up to 20 alpha-numeric characters. Spaces or special characters are not allowed
  - `description` string, nullable: The Job Code description may contain up to 40 alpha-numeric characters. Spaces or special characters are not allowed
  - `isActive` boolean, nullable: Active (Yes/No). The job code is currently active or inactive
  - `isCertified` boolean, nullable: Certified Job (Yes/No). This is a certified job code as per the CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) job costing report by industry
  - `payEntry` PayEntryDto: Override Pay Entry Only
    - `shift` string, nullable: This field is used to enter an override company-defined shift code to be charged by the employee
    - `rateCode` string, nullable: The employee’s pay rate. If no rate is entered, the employees base rate will be used
    - `rate` number, double, nullable: The rate of pay for the job code
    - `addingRateConstant` number, double, nullable: Rate + or + Is employee pay rate + the SD Schedule Differential plus or times the bonus
    - `multiplyingRateConstant` number, double, nullable: Rate X or + Is employee pay rate X the SD Schedule Differential plus or times the bonus
    - `workerComputedCode` string, nullable: The company defined workers comp code for work performed by the employee
    - `tax` TaxDto: State Tax
      - `state` string, nullable: State
      - `local1` string, nullable: This is the local tax code used for the job code
      - `local2` string, nullable: This is the second local tax code used for the job code
      - `local3` string, nullable: This is the third local tax code used for the job code
  - `address` CompanyAddressDto: Address
    - `line1` string, nullable: The address where the job code will be used
    - `line2` string, nullable: The address where the job code will be used
    - `city` string, nullable: The city where the job code will be used
    - `state` string, nullable: The state where the job code will be used
    - `zip` string, nullable: The zip code where the job code will be used
    - `county` string, nullable: The county where the job code will be used
    - `country` string, nullable: The country where the job code will be used
  - `payrollBasedJournal` PayrollBasedJournalDto: CMS/PBJ Data Only
    - `jobTitleCode` string, nullable: This is a Job Title Code for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs
    - `facilityId` string, nullable: This is a Facility id for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs
    - `stateId` string, nullable: This is a State ID for which the certified job code CMS PBJ Report (Centers for Medicare and Medicaid Services Payroll Based Journal) will be utilized to calculate labor costs

## Response `200`

OK

---

[API](https://skmtc.dev/paylocity/apis/company-level-information.md) - [All operations](https://skmtc.dev/paylocity/apis/company-level-information/llms.txt) - [OpenAPI document](https://skmtc.dev/paylocity/apis/company-level-information/revisions/b0d2a79e4eac?raw)