v1

latestOpenAPI 3.1.02026-07-243113441.2 MB

Companies

Create an admin for the company

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

post/v1/companies/{company_id}/admins

Path parameters

company_idstring required

The UUID of the company

Headers

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

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Request body

first_namestring required

The first name of the admin.

last_namestring required

The last name of the admin.

emailstring 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.

Example request

{
  "first_name": "John",
  "last_name": "Smith",
  "email": "jsmith99@gmail.com"
}

Response

Success

uuidstring required

The unique id of the admin.

emailstring

The email of the admin for Gusto's system.

first_namestring

The first name of the admin.

last_namestring

The last name of the admin.

phonestring nullable

The phone number of the admin.