---
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` 'RETRACED_ADMIN' | 'RETRACED_SALES' | 'RETRACED_PRODUCT_DEVELOPMENT' | 'RETRACED_CUSTOMER_SUCCESS' | 'RETRACED_MARKETING' | 'COMPANY_OWNER' | 'EMPLOYEE', required

## Response `200`

Default Response

- object
  - `id` string, required
  - `userId` string, required
  - `companyId` string, required
  - `role` 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

---

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