---
title: "Create an admin for the company"
method: POST
path: "/v1/companies/{company_id}/admins"
tags: ["Companies"]
---

# Create an admin for the company

`POST /v1/companies/{company_id}/admins`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_id}/admins`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_id/admins/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a new admin for a company.
If the email matches an existing user, this will create an admin account for the current user. Otherwise, this will create a new user.

scope: `company_admin:write`

## Path parameters

- `company_id` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- AdminCreateRequest: The request body for creating a company admin.
  - `first_name` string, required: The first name of the admin.
  - `last_name` string, required: The last name of the admin.
  - `email` string, required: The email of the admin for Gusto's system. If the email matches an existing user, this will create an admin account for them.

## Response `200`

Success

- Admin: The representation of an admin user in Gusto.
  - `uuid` string, required: The unique id of the admin.
  - `email` string: The email of the admin for Gusto's system.
  - `first_name` string: The first name of the admin.
  - `last_name` string: The last name of the admin.
  - `phone` string, nullable: The phone number of the admin.

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

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