Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Signatories

Create a signatory

Creates a company signatory with complete information. The company must not already have a signatory.

A signatory can legally sign forms once the identity verification process is successful. The signatory should be an officer, owner, general partner or LLC member manager, plan administrator, fiduciary, or an authorized representative who is designated to sign agreements on the company's behalf. An officer is the president, vice president, treasurer, chief accounting officer, etc. There can only be a single primary signatory in a company.

Webhooks

  • signatory.created: Fires when a signatory is successfully created.

Related guides

scope: signatories:manage

post/v1/companies/{company_uuid}/signatories

Path parameters

company_uuidstring 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 signatory's first name.

middle_initialstring
last_namestring required

The signatory's last name.

titlestring required

The signatory's title (e.g. CEO, President).

phonestring required

The signatory's phone number.

birthdaystring date required

The signatory's date of birth.

emailstring email required

The signatory's email address.

ssnstring required

The signatory's SSN.

Response

Successful

uuidstring required
first_namestring nullable
last_namestring nullable
titlestring nullable
phonestring nullable
emailstring
birthdaystring nullable
is_adminboolean

Whether or not the signatory is also the payroll admin of the company.

has_ssnboolean

Indicates whether the signatory has an SSN in Gusto.

versionstring

The current version of the signatory. See the versioning guide for information on how to use this field.

identity_verification_status'Pass' | 'Fail' | 'Skipped' nullable
StatusDescription
PassSignatory can sign all forms
FailSignatory cannot sign forms
SkippedSignatory cannot sign Form 8655 until the form is manually uploaded as wet-signed
nullIdentity verification process has not been completed