---
title: "Creates a single new employees used in Xero payrun"
method: POST
path: "/Employees"
tags: ["Accounting"]
---

# Creates a single new employees used in Xero payrun

`POST /Employees`

## Query parameters

- `summarizeErrors` boolean

## Headers

- `Idempotency-Key` string

## Request body

- Employees
  - `Employees` Employee[]
    - `EmployeeID` string, uuid — The Xero identifier for an employee e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
    - `Status` 'ACTIVE' | 'ARCHIVED' | 'GDPRREQUEST' | 'DELETED' — Current status of an employee – see contact status types
    - `FirstName` string — First name of an employee (max length = 255)
    - `LastName` string — Last name of an employee (max length = 255)
    - `ExternalLink` ExternalLink
      - `LinkType` 'Facebook' | 'GooglePlus' | 'LinkedIn' | 'Twitter' | 'Website' — See External link types
      - `Url` string — URL for service e.g. http://twitter.com/xeroapi
      - `Description` string
    - `UpdatedDateUTC` string
    - `StatusAttributeString` string — A string to indicate if a invoice status
    - `ValidationErrors` ValidationError[] — Displays array of validation error messages from the API
      - `Message` string — Validation error message

## Response `200`

Success - return response of type Employees array with new Employee

- Employees
  - `Employees` Employee[]
    - `EmployeeID` string, uuid — The Xero identifier for an employee e.g. 297c2dc5-cc47-4afd-8ec8-74990b8761e9
    - `Status` 'ACTIVE' | 'ARCHIVED' | 'GDPRREQUEST' | 'DELETED' — Current status of an employee – see contact status types
    - `FirstName` string — First name of an employee (max length = 255)
    - `LastName` string — Last name of an employee (max length = 255)
    - `ExternalLink` ExternalLink
      - `LinkType` 'Facebook' | 'GooglePlus' | 'LinkedIn' | 'Twitter' | 'Website' — See External link types
      - `Url` string — URL for service e.g. http://twitter.com/xeroapi
      - `Description` string
    - `UpdatedDateUTC` string
    - `StatusAttributeString` string — A string to indicate if a invoice status
    - `ValidationErrors` ValidationError[] — Displays array of validation error messages from the API
      - `Message` string — Validation error message

## Other responses

- `400` — A failed request due to validation error

---

[API](https://skmtc.dev/xeroapi/apis/xero-accounting-api.md) · [All operations](https://skmtc.dev/xeroapi/apis/xero-accounting-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xeroapi/apis/xero-accounting-api/revisions/3aad5a420f76?raw)