Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Signatories

Update a signatory

Updates a signatory that has been either invited or created. If the signatory has been created with minimal information through the Invite a signatory endpoint, then the first update must contain all attributes specified in the request body in order to start the identity verification process.

Related guides

scope: signatories:write

put/v1/companies/{company_uuid}/signatories/{signatory_uuid}

Path parameters

company_uuidstring required

The UUID of the company

signatory_uuidstring required

The UUID of the signatory

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

versionstring required

Current version of the signatory (required for optimistic concurrency).

first_namestring
middle_initialstring
last_namestring
titlestring
phonestring
birthdaystring date
ssnstring

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