---
title: "Add a user to a company by id"
method: POST
path: "/api/v4/f/{firm_id}/companies/{company_id}/users"
tags: ["Companies"]
---

# Add a user to a company by id

`POST /api/v4/f/{firm_id}/companies/{company_id}/users`

## Request

- Base URL: `https://live.getsilverfin.com`
- URL: `https://live.getsilverfin.com/api/v4/f/{firm_id}/companies/{company_id}/users`
- Auth: OAuth 2
  - Authorization code: `https://live.getsilverfin.com/oauth/authorize`
  - Token URL: `https://live.getsilverfin.com/oauth/token` scopes: `administration:write`

Add a user to a company by id. <br>
<b>Required scope(s):</b> `administration:write`

## Path parameters

- `firm_id` integer, required
- `company_id` integer, required

## Headers

- `Accept` string

## Request body `multipart/form-data`

- object
  - `user_id` integer, required
  - `role` string, required: Can either be firm, customer or external
  - `can_manage_users` boolean

## Response `201`

Successful response

---

[API](https://skmtc.dev/silverfin/apis/silverfin-api.md) - [All operations](https://skmtc.dev/silverfin/apis/silverfin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/silverfin/apis/silverfin-api/revisions/e418e4fc02e8?raw)