---
title: "Import Xero Employees"
method: POST
path: "/v1/matters/{matter_id}/employees/actions/import/xero"
tags: ["employees"]
---

# Import Xero Employees

`POST /v1/matters/{matter_id}/employees/actions/import/xero`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/employees/actions/import/xero`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- XeroOrganisationSelection
  - `organisation_id` string, uuid, required
  - `include_pay_history` boolean
  - `pay_history_from` string, date, nullable
  - `pay_history_to` string, date, nullable
  - `capture_id` string, uuid, required
  - `preview_snapshot_sha256` string, required
  - `skipped_employee_keys` string[]

## Response `202`

Successful Response

- EmployeeImportRead
  - `import_id` string, uuid, required
  - `source_kind` 'xero' | 'generic_excel', required
  - `operation` 'prepare' | 'import', required
  - `status` 'pending' | 'running' | 'completed' | 'cancelled' | 'retryable' | 'failed', required
  - `progress` object, required
  - `total_row_count` integer, required
  - `imported_count` integer, required
  - `review_count` integer, required
  - `retrieval_time` string, date-time, nullable, required
  - `safe_issue_code` string, nullable, required
  - `can_cancel` boolean, required
  - `created_at` string, date-time, required
  - `finished_at` string, date-time, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/bf4373130521?raw)