> ## Documentation Index > Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a HR Position > ## Create HR Positions # HrPositionsMaster API ## Endpoint /hcm-rest-api/rest/1/HrPositionsMaster ### ## OpenAPI ````json POST /hcm-rest-api/rest/1/HrPositionsMaster/ { "openapi": "3.0.0", "info": { "title": "API Catalog", "description": "", "version": "1.0.0" }, "servers": [ { "url": "https://mobtest.cmiccloudr12.com/cmictestrti", "description": "CMIC API Server" } ], "security": [ { "cmicBasicAuth": [] } ], "tags": [ { "name": "Highlights" }, { "name": "Asset Management | Equipment" }, { "name": "Asset Management | Fixed Assets" }, { "name": "Asset Management | Purchase Order" }, { "name": "Asset Management | Inventory" }, { "name": "Asset Management | Requisition" }, { "name": "Asset Management | Purchase Change Order" }, { "name": "Bim Model" }, { "name": "Bim Model Revision" }, { "name": "Bim Tag Model" }, { "name": "Bim Tags" }, { "name": "Bim FileUpload Jersey" }, { "name": "Core System | Business Partners" }, { "name": "Core System | Business Partner Addresses" }, { "name": "Core System | Bank" }, { "name": "Core System | Currency" }, { "name": "Core System | Exchange Rates" }, { "name": "Core System | Global Table Text Codes" }, { "name": "Core System | Global Table Regions" }, { "name": "Core System | Terms" }, { "name": "Core System | System Contact" }, { "name": "Core System | Weight Measures" }, { "name": "Core System | Field User Defined Classifiers" }, { "name": "Core System | User Defined Classifiers by Object" }, { "name": "Core System | User Extension Definitions by Object" }, { "name": "Core System | User Extention Field Data Value" }, { "name": "Core System | User Extension Values by Object" }, { "name": "Core System | User System Role" }, { "name": "Core System | User Project Role" }, { "name": "Core System | Documents by Object" }, { "name": "Core System | Audit Status Log by Object" }, { "name": "Core System | Licensed Users" }, { "name": "Core System | Company Access" }, { "name": "Core System | Copy User Settings" }, { "name": "Core System | User Maintenance" }, { "name": "Core System | User Roles" }, { "name": "Core System | Security Groups" }, { "name": "Core System | Job/Project Security" }, { "name": "Core System | Weight Measure with Conversions Code" }, { "name": "Core System | Weight Measure Conversions Code" }, { "name": "Core System | User-defined-fields" }, { "name": "Core System | User-extension" }, { "name": "ECM and Workflow | Image Manager" }, { "name": "Financials | General Ledger" }, { "name": "Financials | Accounts Payable" }, { "name": "Financials | Accounts Receivable" }, { "name": "Preventative Maintenance | Issue Work Orders" }, { "name": "Preventative Maintenance | Issue Work Items" }, { "name": "Preventative Maintenance | Issue Work Budgets" }, { "name": "Preventative Maintenance | Issue Priorities" }, { "name": "Preventative Maintenance | Issue Status" }, { "name": "Preventative Maintenance | Issue Types" }, { "name": "Preventative Maintenance | Accumulative Equipment" }, { "name": "Preventative Maintenance | Work Orders" }, { "name": "Preventative Maintenance | Work Items" }, { "name": "Preventative Maintenance | Work Budgets" }, { "name": "Preventative Maintenance | Priorities" }, { "name": "Preventative Maintenance | Tasks" }, { "name": "HCM | UKG Pay Deductions" }, { "name": "HCM | UKG Pay Earnings" }, { "name": "HCM | UKG Pay Headers" }, { "name": "HCM | UKG Pay Taxes" }, { "name": "HCM | Payroll Geographical States" }, { "name": "HCM | Payroll Trades" }, { "name": "HCM | Payroll Union" }, { "name": "HCM | Payroll Pay Runs" }, { "name": "HCM | Payroll Pay Groups" }, { "name": "HCM | Payroll Tax" }, { "name": "HCM | Payroll Worker Compensation" }, { "name": "HCM | Payroll Work Locations" }, { "name": "HCM | Payroll Trade Pay Rates" }, { "name": "HCM | Payroll Union Pay Rates" }, { "name": "HCM | Payroll Job Pay Rates" }, { "name": "HCM | Payroll Master Benefits" }, { "name": "HCM | Payroll Master Deductions" }, { "name": "HCM | Payroll Ben/Ded/Leave Base Codes" }, { "name": "HCM | Payroll Ben/Ded Plans" }, { "name": "HCM | Payroll Ben/Ded Plan Options" }, { "name": "HCM | Payroll Company Benefits" }, { "name": "HCM | Payroll Company Deductions" }, { "name": "HCM | Payroll Vertex Geographic Locations" }, { "name": "HCM | Payroll Checks" }, { "name": "HCM | Payroll Timesheets" }, { "name": "HCM | Employee" }, { "name": "HCM | Employee (Minimum payload)" }, { "name": "HCM | Employee History" }, { "name": "HCM | Tax Exemptions" }, { "name": "HCM | Employee Tax Overrides" }, { "name": "HCM | Employee Pay Splits" }, { "name": "HCM | Employee Benefits" }, { "name": "HCM | Employee Clock In and Out" }, { "name": "HCM | Employee Deductions" }, { "name": "HCM | Employee Leaves" }, { "name": "HCM | Employee Leave History" }, { "name": "HCM | Employee Hour Types" }, { "name": "HCM | Employee Pay History" }, { "name": "HCM | Employee Work Statuses" }, { "name": "HCM | Employee Security Group" }, { "name": "HCM | Crewtime Crew" }, { "name": "HCM | Crewtime Employee Timesheet" }, { "name": "HCM | Crewtime Equipment Timesheet" }, { "name": "HCM | Crew Maintenance Activity Assignment" }, { "name": "HCM | Crew Maintenance Member Assignment" }, { "name": "HCM | Crew Maintenance Member Trade and Union Assignment" }, { "name": "HCM | Crew Maintenance Equipment Assignment" }, { "name": "HCM | Crew Maintenance Equipment Detail Assignment" }, { "name": "HCM | HR Requisitions" }, { "name": "HCM | HR Relations" }, { "name": "HCM | HR Employee Skills" }, { "name": "HCM | HR Incident" }, { "name": "HCM | HR Employee Relatives / Dependents" }, { "name": "HCM | HR Employee Positions" }, { "name": "HCM | HR Applicants" }, { "name": "HCM | HR Applications" }, { "name": "HCM | Vertex Location City" }, { "name": "HCM | HR Application History" }, { "name": "HCM | HR Dependent Benefits" }, { "name": "HCM | HR Dependent Deductions" }, { "name": "HCM | HR Employee Elected Plans" }, { "name": "HCM | HR Employee Training Certifications" }, { "name": "HCM | HR Trainings" }, { "name": "HCM | E-Timesheets" }, { "name": "HCM | System Contacts" }, { "name": "HCM | System User Payroll Security Group" }, { "name": "HCM | Payroll Timesheet Posting" }, { "name": "HCM | CrewTimesheet Posting" }, { "name": "HCM | HR Positions Master" }, { "name": "HCM | Payroll Pay Periods" }, { "name": "HCM | Payroll Rate Codes" }, { "name": "HCM | Payroll Overhead Codes and Rates" }, { "name": "HCM | Payroll Assigned Overhead to Jobs" }, { "name": "Materials Management | Material Sale Orders" }, { "name": "Materials Management | Material Sale Orders Details" }, { "name": "Materials Management | Truck Rate Detail" }, { "name": "Opportunity Management | Competitors" }, { "name": "Opportunity Management | Opportunities" }, { "name": "Opportunity Management | Revenue Details" }, { "name": "Opportunity Management | Opportunity History" }, { "name": "Opportunity Management | Organization" }, { "name": "Project Controls | Job Billing" }, { "name": "Project Controls | Job Cost" }, { "name": "Project Controls | PCI Details" }, { "name": "Project Controls | Unposted PCI Details" }, { "name": "Project Controls | PCI Headers" }, { "name": "Project Controls | Owner Change Orders" }, { "name": "Project Controls | CM Statuses" }, { "name": "Project Controls | CM Types" }, { "name": "Project Controls | CM Vendor Details" }, { "name": "Project Controls | Post PCI" }, { "name": "Project Management | Uploading Documents" }, { "name": "Project Management | Downloading Documents" }, { "name": "Project Management | Foreign Bid Item Imports" }, { "name": "Project Management | Communications" }, { "name": "Project Management | Daily Journals" }, { "name": "Project Management | Communications Types" }, { "name": "Project Management | Daily Journal Daily Work Plans" }, { "name": "Project Management | Daily Journal Field Forces" }, { "name": "Project Management | Daily Journal Labour" }, { "name": "Project Management | Daily Journal Materials" }, { "name": "Project Management | Daily Journal Owner Equipment" }, { "name": "Project Management | Daily Journal Quality Control" }, { "name": "Project Management | Daily Journal Tasks" }, { "name": "Project Management | Daily Journal Trade Equipment" }, { "name": "Project Management | Daily Journal Transactions" }, { "name": "Project Management | Daily Journal User Defined Data" }, { "name": "Project Management | Daily Journal Visitors" }, { "name": "Project Management | Daily Journal Bill Details" }, { "name": "Project Management | Field Work Directives" }, { "name": "Project Management | Contract Types" }, { "name": "Project Management | Company Contacts" }, { "name": "Project Management | Distribution BCC" }, { "name": "Project Management | Distribution CC" }, { "name": "Project Management | Field Work Directive Statuses" }, { "name": "Project Management | Issues" }, { "name": "Project Management | Key Players" }, { "name": "Project Management | Meetings" }, { "name": "Project Management | Meeting Attendees" }, { "name": "Project Management | Meeting Item Statuses" }, { "name": "Project Management | Meeting Tracks" }, { "name": "Project Management | Notes" }, { "name": "Project Management | Projects" }, { "name": "Project Management | Project Items" }, { "name": "Project Management | Project Item Phase Segment Sums" }, { "name": "Project Management | Project Partners" }, { "name": "Project Management | Notices" }, { "name": "Project Management | Notice Statuses" }, { "name": "Project Management | Owner JS Query" }, { "name": "Project Management | PCI Real Locations" }, { "name": "Project Management | Project Contacts" }, { "name": "Project Management | RFIs (Requests for Information)" }, { "name": "Project Management | RFI Statuses" }, { "name": "Project Management | Submittal Packages" }, { "name": "Project Management | Submittal Package Details" }, { "name": "Project Management | Submittal Package Status" }, { "name": "Project Management | Submittals" }, { "name": "Project Management | Submittal Status" }, { "name": "Project Management | Transmittals" }, { "name": "Project Management | Subcontract Headers" }, { "name": "Project Management | Subcontract Schedules" }, { "name": "Project Management | Subcontract Sechedule Phase Segment Sums" }, { "name": "Project Management | User Roles" }, { "name": "Project Management | Punchlists" }, { "name": "Project Management | Punchlist Details" }, { "name": "Project Management | Punchlist Statuses" }, { "name": "Project Management | Meeting Items" }, { "name": "Project Management | Self Perform Vendor" }, { "name": "Project Management | Submittal Types" }, { "name": "Project Management | Assign contact and partner to project" }, { "name": "Project Management | Subcontract Prequal" }, { "name": "Project Management | Bid Item Package" } ], "paths": { "/hcm-rest-api/rest/1/HrPositionsMaster/": { "post": { "tags": [ "HCM | HR Positions Master" ], "summary": "Create a HR Position", "description": "## Create HR Positions\n# HrPositionsMaster API\n\n## Endpoint\n/hcm-rest-api/rest/1/HrPositionsMaster\n\n###", "requestBody": { "content": { "application/json": { "schema": { "type": "object", "properties": { "PosActiveFlag": { "type": "string", "maxLength": 1, "description": "Indicates whether the position is active (Y/N).\n\n💻 UI Fieldname: Active Flag" }, "PosAllowEtimeEntryFlag": { "type": "string", "maxLength": 1, "description": "Indicates whether employees in this position are allowed to enter in eTime (Y/N).\n\n💻 UI Fieldname: Allow eTime Entry" }, "PosCode": { "type": "string", "maxLength": 10, "description": "The unique identifier of a position. If the **JSP Position ID Auto Numbering** option is enabled, this value is automatically generated.\n\n💻 UI Fieldname: Position Code" }, "PosCtrlPos": { "type": "string", "maxLength": 30, "description": "The position code of the controlling position for this position.\n\n💻 UI Fieldname: Controlling Position" }, "PosDefaultJobTitle": { "type": "string", "maxLength": 1000, "description": "The default job title for this position, used when the position is assigned to an employee without a specific job title.\n\n💻 UI Fieldname: Default Job Title" }, "PosDescription": { "type": "string", "maxLength": 60, "description": "The description of the position.\n\n💻 UI Fieldname: Position Description" }, "PosEeoClass": { "type": "string", "maxLength": 4, "description": "The EEO classification code for the position.\n\n💻 UI Fieldname: EEO Class" }, "PosEeoClassDesc": { "type": "string", "maxLength": 30, "description": "The description of the EEO class code.\n\n💻 UI Fieldname: EEO Class Description" }, "PosExpiryDate": { "type": "string", "description": "The date when the position expires and is no longer active.\n\n💻 UI Fieldname: Expiry Date" }, "PosFlsaExemptFlag": { "type": "string", "maxLength": 1, "description": "Indicates whether the position is exempt from the Fair Labor Standards Act (FLSA) overtime requirements (E-Exempt/N-Non-Exempt).\n\n💻 UI Fieldname: FLSA Exempt Flag" }, "PosFlsaExemptFlagDesc": { "type": "string", "maxLength": 10, "description": "The description of the FLSA exempt flag.\n\n💻 UI Fieldname: FLSA Exempt Description" }, "PosGradeCode": { "type": "string", "maxLength": 4, "description": "The grade code for the position.\n\n💻 UI Fieldname: Grade Code" }, "PosGradeDesc": { "type": "string", "maxLength": 30, "description": "The description of the grade code.\n\n💻 UI Fieldname: Grade Description" }, "PosHrpdCode": { "type": "string", "maxLength": 10, "description": "The HRPD (Physical Demand) code for the position.\n\n💻 UI Fieldname: HRPD Code" }, "PosHrpdDesc": { "type": "string", "maxLength": 30, "description": "The description of the HRPD code.\n\n💻 UI Fieldname: HRPD Description" }, "PosHrweCode": { "type": "string", "maxLength": 10, "description": "The HRWE (Work Environment) code for the position.\n\n💻 UI Fieldname: HRWE Code" }, "PosHrweDesc": { "type": "string", "maxLength": 30, "description": "The description of the HRWE code.\n\n💻 UI Fieldname: HRWE Description" }, "PosIuCreateDate": { "type": "string", "description": "The date and time when the position was created.\n\n💻 UI Fieldname: Created Date" }, "PosIuCreateUser": { "type": "string", "maxLength": 30, "description": "The name of the user who created the position.\n\n💻 UI Fieldname: Created By" }, "PosIuUpdateDate": { "type": "string", "description": "The date and time when the position was last updated.\n\n💻 UI Fieldname: Updated Date" }, "PosIuUpdateUser": { "type": "string", "maxLength": 30, "description": "The name of the user who made the last update to the position.\n\n💻 UI Fieldname: Updated By" }, "PosJobSummary": { "type": "string", "maxLength": 4000, "description": "A summary of the job duties and responsibilities for the position.\n\n💻 UI Fieldname: Job Summary" }, "PosLastUpdDate": { "type": "string", "description": "The date and time when the position was last updated.\n\n💻 UI Fieldname: Last Updated Date" }, "PosResponsibilities": { "type": "string", "maxLength": 4000, "description": "A detailed description of the job duties and responsibilities for the position.\n\n💻 UI Fieldname: Responsibilities" }, "PosSafeCertFlag": { "type": "string", "maxLength": 1, "description": "Indicates whether the position requires a safety certification (Y/N).\n\n💻 UI Fieldname: Safety Certification Required" }, "PosShortDesc": { "type": "string", "maxLength": 16, "description": "A short description of the position, used for display purposes.\n\n💻 UI Fieldname: Short Description" }, "PosStatusCode": { "type": "string", "maxLength": 1, "description": "The status code for the position.\n\n💻 UI Fieldname: Status Code" }, "PosTradeCode": { "type": "string", "maxLength": 30, "description": "The trade code for the position, used to classify positions based on the type of work performed.\n\n💻 UI Fieldname: Trade Code" }, "PosTrainDesc": { "type": "string", "maxLength": 4000, "description": "A description of the training requirements for the position.\n\n💻 UI Fieldname: Training Description" }, "PosTrainType": { "type": "string", "maxLength": 1, "description": "The type of training required for the position (0-Regular Employee, 1-Apprentice, 2-Trainee, 3-Student).\n\n💻 UI Fieldname: Training Type" }, "PosUser": { "type": "string", "maxLength": 30, "description": "The name of the user who made the last update to the position.\n\n💻 UI Fieldname: User" }, "PosVUuid": { "type": "string", "maxLength": 64, "description": "Unique UUID of the row.\n\n💻 UI Fieldname: Unique Row ID" } }, "required": [ "PosActiveFlag", "PosDescription", "PosEeoClass", "PosFlsaExemptFlag", "PosShortDesc", "PosTrainType", "PosUser" ], "example": { "PosActiveFlag": "Y", "PosAllowEtimeEntryFlag": null, "PosCode": "POS1", "PosCtrlPos": null, "PosDefaultJobTitle": null, "PosDescription": "Application Developer", "PosEeoClass": "008", "PosExpiryDate": null, "PosFlsaExemptFlag": "E", "PosFlsaExemptFlagDesc": "Non-Exempt", "PosGradeCode": "HZ", "PosHrpdCode": "OFFICE", "PosHrweCode": "OUT-ALL", "PosResponsibilities": null, "PosSafeCertFlag": "Y", "PosShortDesc": "App Dev", "PosStatusCode": null, "PosTrainType": "2", "PosUser": "DA", "PosVUuid": "" } } } } }, "responses": { "201": { "description": "Created", "content": { "text/plain": { "schema": { "type": "string" }, "example": "{\r\n \"PosActiveFlag\": \"Y\",\r\n \"PosAllowEtimeEntryFlag\": null,\r\n \"PosCode\": \"POS_1\",\r\n \"PosCtrlPos\": null,\r\n \"PosDefaultJobTitle\": null,\r\n \"PosDescription\": \"Application Developer\",\r\n \"PosEeoClass\": \"008\",\r\n \"PosEeoClassDesc\": \"Personnel & Labor Relation Mgr\",\r\n \"PosExpiryDate\": null,\r\n \"PosFlsaExemptFlag\": \"E\",\r\n \"PosFlsaExemptFlagDesc\": \"Exempt\",\r\n \"PosGradeCode\": \"H\",\r\n \"PosGradeDesc\": \"high Quality\",\r\n \"PosHrpdCode\": \"OFFICE\",\r\n \"PosHrpdDesc\": \"Internal Office Position\",\r\n \"PosHrweCode\": \"OUT-ALL\",\r\n \"PosHrweDesc\": \"Outside All Seasons\",\r\n \"PosIuCreateDate\": \"2026-06-29T19:11:02-04:00\",\r\n \"PosIuCreateUser\": \"FARHA\",\r\n \"PosIuUpdateDate\": null,\r\n \"PosIuUpdateUser\": null,\r\n \"PosJobSummary\": null,\r\n \"PosLastUpdDate\": \"2026-06-29T19:11:02-04:00\",\r\n \"PosResponsibilities\": null,\r\n \"PosSafeCertFlag\": \"Y\",\r\n \"PosShortDesc\": \"App Dev\",\r\n \"PosStatusCode\": null,\r\n \"PosTradeCode\": null,\r\n \"PosTrainDesc\": \"Trainee\",\r\n \"PosTrainType\": \"2\",\r\n \"PosUser\": \"DA\",\r\n \"PosVUuid\": \"556D7F5AF6A78660E0630B811DAC9C54\",\r\n \"links\": [\r\n {\r\n \"rel\": \"self\",\r\n \"href\": \"https://dev7v12mob.cmic.ca:443/cmicdevv12/hcm-rest-api/rest/1/HrPositionsMaster/556D7F5AF6A78660E0630B811DAC9C54\",\r\n \"name\": \"HrPositionsMaster\",\r\n \"kind\": \"item\"\r\n },\r\n {\r\n \"rel\": \"canonical\",\r\n \"href\": \"https://dev7v12mob.cmic.ca:443/cmicdevv12/hcm-rest-api/rest/1/HrPositionsMaster/556D7F5AF6A78660E0630B811DAC9C54\",\r\n \"name\": \"HrPositionsMaster\",\r\n \"kind\": \"item\"\r\n }\r\n ]\r\n}" } } } } } } }, "components": { "securitySchemes": { "cmicBasicAuth": { "type": "http", "scheme": "basic", "description": "Basic authentication" } } } } ````