---
title: "Create Employee Role"
method: POST
path: "/api/v2/core/employee-roles"
tags: ["Employee Role"]
---

# Create Employee Role

`POST /api/v2/core/employee-roles`

Create an employee role in Eightfold

## Headers

- `Authorization` string, required

## Request body

- ExternalRoleSchema
  - `calibration` CalibrationDataSchema
    - `flags` string[], nullable — flags
    - `graduationYear` string, nullable — graduationYear
    - `workCategories` string[], nullable — workCategories
    - `skills` string[], nullable — skills
    - `diversity` string[], nullable — diversity
    - `idealCandidates` string[], nullable — ideal_candidates
    - `companies` string[], nullable — companies
    - `titles` string[], nullable — titles
    - `educationLevel` string[], nullable — different education levels
    - `relocation` string[], nullable — relocation
    - `seniorities` string[], nullable — seniorities
    - `maxExperience` integer, nullable — maxExperience
    - `schools` string[], nullable — schools
    - `skillProficiencies` SkillProficiency[], nullable — skill proficiencies of the role
      - `proficiency` number, float, nullable — proficiency of the role
      - `skillGroupList` SkillGroupList[], nullable — skill group list of a role
        - `proficiency` number, float, nullable — group proficiency of the skill group
        - `groupName` string, nullable — name of the skill group
        - `level` string, nullable — level of the role
        - `skillCategory` string, nullable — skill category of the skill group
      - `level` string, nullable — level of the role
      - `name` string, nullable — name of the role
    - `idealCandidateUrls` string[], nullable — idealCandidatesUrls
    - `minExperience` integer, nullable — minExperience
    - `notes` string, nullable — notes
    - `locations` string[], nullable — locations
  - `roleSource` string, nullable — source of the role
  - `id` string, nullable — id of the role
  - `skillProficiencies` SkillProficiency[], nullable — skill proficiencies of the role
    - `proficiency` number, float, nullable — proficiency of the role
    - `skillGroupList` SkillGroupList[], nullable — skill group list of a role
      - `proficiency` number, float, nullable — group proficiency of the skill group
      - `groupName` string, nullable — name of the skill group
      - `level` string, nullable — level of the role
      - `skillCategory` string, nullable — skill category of the skill group
    - `level` string, nullable — level of the role
    - `name` string, nullable — name of the role
  - `associatedTags` RoleTag[], nullable — associated tags with the role
    - `tagValues` string[], nullable — value of the tag
    - `tagName` string, nullable — name of the tag
  - `parentRoleId` string, nullable — parent role id of the role
  - `childrenRoleId` string[], nullable — children of role
  - `title` string, nullable — title of the role
  - `displayTags` RoleTag[], nullable — display tags of the role
    - `tagValues` string[], nullable — value of the tag
    - `tagName` string, nullable — name of the tag

## Response `200`

OK

- ExternalRoleSchema
  - `calibration` CalibrationDataSchema
    - `flags` string[], nullable — flags
    - `graduationYear` string, nullable — graduationYear
    - `workCategories` string[], nullable — workCategories
    - `skills` string[], nullable — skills
    - `diversity` string[], nullable — diversity
    - `idealCandidates` string[], nullable — ideal_candidates
    - `companies` string[], nullable — companies
    - `titles` string[], nullable — titles
    - `educationLevel` string[], nullable — different education levels
    - `relocation` string[], nullable — relocation
    - `seniorities` string[], nullable — seniorities
    - `maxExperience` integer, nullable — maxExperience
    - `schools` string[], nullable — schools
    - `skillProficiencies` SkillProficiency[], nullable — skill proficiencies of the role
      - `proficiency` number, float, nullable — proficiency of the role
      - `skillGroupList` SkillGroupList[], nullable — skill group list of a role
        - `proficiency` number, float, nullable — group proficiency of the skill group
        - `groupName` string, nullable — name of the skill group
        - `level` string, nullable — level of the role
        - `skillCategory` string, nullable — skill category of the skill group
      - `level` string, nullable — level of the role
      - `name` string, nullable — name of the role
    - `idealCandidateUrls` string[], nullable — idealCandidatesUrls
    - `minExperience` integer, nullable — minExperience
    - `notes` string, nullable — notes
    - `locations` string[], nullable — locations
  - `roleSource` string, nullable — source of the role
  - `id` string, nullable — id of the role
  - `skillProficiencies` SkillProficiency[], nullable — skill proficiencies of the role
    - `proficiency` number, float, nullable — proficiency of the role
    - `skillGroupList` SkillGroupList[], nullable — skill group list of a role
      - `proficiency` number, float, nullable — group proficiency of the skill group
      - `groupName` string, nullable — name of the skill group
      - `level` string, nullable — level of the role
      - `skillCategory` string, nullable — skill category of the skill group
    - `level` string, nullable — level of the role
    - `name` string, nullable — name of the role
  - `associatedTags` RoleTag[], nullable — associated tags with the role
    - `tagValues` string[], nullable — value of the tag
    - `tagName` string, nullable — name of the tag
  - `parentRoleId` string, nullable — parent role id of the role
  - `childrenRoleId` string[], nullable — children of role
  - `title` string, nullable — title of the role
  - `displayTags` RoleTag[], nullable — display tags of the role
    - `tagValues` string[], nullable — value of the tag
    - `tagName` string, nullable — name of the tag

---

[API](https://skmtc.net/eightfold/apis/api-server-v2-service-service.md) · [All operations](https://skmtc.net/eightfold/apis/api-server-v2-service-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eightfold/api-server-v2-service-service/revisions/0fb26f4e41bf/schema)