---
title: "Create and invite a Company Manager"
method: POST
path: "/v1/company-managers"
tags: ["Company Managers"]
---

# Create and invite a Company Manager

`POST /v1/company-managers`

Create a Company Manager and sends the invitation email for signing in to the Remote Platform.

## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage company resources (`company_admin`) | - | Manage managers (`company_manager:write`) |

## Query parameters

- `actions` string

## Headers

- `Authorization` string, required

## Request body

- CompanyManagerParams
  - `company_id` string — The Company ID. Required if the access token can access multiple companies. Optional otherwise.
  - `email` string, email, required — The work email of the company manager
  - `name` string, required — The name of the company manager
  - `role` string, required — The role assigned for the new manager. The value should be one of the following: - `admin`: an Admin can manage most of the resources in remote. - `onboarding_manager`: an Onboarding Manager can add, see and manage new hires. - `people_manager`: a People Manager can view employee profiles of the team members they manage and approve and decline time off and expenses for their employees.

## Response `201`

Success

- CompanyManagerData
  - `company_manager` CompanyManager, required
    - `company_id` string, required — Company ID
    - `role` string, required — Company Manager role.
    - `user_email` string, required — User Email
    - `user_id` string, required — User ID
    - `user_name` string, required — User's name

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too many requests

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)