---
title: "Add a user to a company"
method: POST
path: "/api/admin/user-companies/"
tags: ["Administration/User Companies"]
---

# Add a user to a company

`POST /api/admin/user-companies/`

## Request body

- object
  - `companyId` string, required
  - `userId` string, required
  - `role` string, required

## Response `200`

Default Response

- object
  - `id` string, required
  - `userId` string, required
  - `companyId` string, required
  - `isPrimary` boolean, required
  - `hasAgreedWithTerms` boolean, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response
- `409` — Default Response

## Changes

> 49 revisions in range; 1 not diffed.

- **2026-09-17** `b45b2427a621` — 1 breaking
  - removed the required property `role` from the response with the `200` status
- **2026-09-14** `3d3a05fa3548` — 1 breaking
  - the response property `role` became nullable for the status `200`
- **2026-09-13** `8049f7c86213` — 8 breaking
  - removed the enum value `COMPANY_OWNER` of the request property `role`
  - removed the enum value `EMPLOYEE` of the request property `role`
  - removed the enum value `RETRACED_ADMIN` of the request property `role`
  - removed the enum value `RETRACED_CUSTOMER_SUCCESS` of the request property `role`
  - …4 more

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/admin/user-companies/post.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/retraced/apis/api-reference/revisions/940ef021e2d5?raw)