---
title: "Link Employee to User"
method: POST
path: "/v1/employees/link-user"
tags: ["Employees"]
---

# Link Employee to User

`POST /v1/employees/link-user`

Link an employee to a user account with specified roles

## Request body

- object
  - `employeeId` string, required
  - `userId` string, required
  - `role` string[]

## Response `201`

Employee linked successfully

- object — Employee linked successfully
  - `success` boolean, required
  - `linkId` string, required — ID of the created link
  - `message` string, required

## Other responses

- `400` — Validation error
- `401` — Authentication error
- `404` — Employee or user not found
- `500` — Server error

---

[API](https://skmtc.net/bluehive-health/apis/bluehive-api.md) · [All operations](https://skmtc.net/bluehive-health/apis/bluehive-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluehive-health/bluehive-api/revisions/ae97a9add0ba/schema)