---
title: "Set Employee External Reference"
method: PUT
path: "/employees/v1/{employeeId}/external-reference"
tags: ["Employees"]
---

# Set Employee External Reference

`PUT /employees/v1/{employeeId}/external-reference`

Set the external reference for an employee.

## Path parameters

- `employeeId` string, uuid, required

## Request body

- SetExternalIdRequestDto — Request to set the external reference for an employee.
  - `externalReference` string, nullable, required — The external reference to set for the employee. Multiple employees can have the same external reference. If set, the minimum length is 1 character and the maximum length is 36 characters.

## Response `200`

OK

- SetExternalIdResponseDto — Response to setting the external reference for an employee.
  - `externalReference` string, nullable, required — The external reference that was set.

## Other responses

- `401` — Token Expired. Re-authenticate to obtain a new token.
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation failed

---

[API](https://skmtc.dev/bright/apis/customer-api.md) · [All operations](https://skmtc.dev/bright/apis/customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bright/customer-api/revisions/77b0e300c3a5/schema)