Sign in

v1

latestOpenAPI 3.1.02026-07-243113441.2 MB
Signatories

Invite a signatory

Creates a signatory with minimal information. This signatory can be invited to provide more information through the Update a signatory endpoint. This will start the identity verification process and allow the signatory to be verified to sign documents.

Related guides

scope: signatories:manage

post/v1/companies/{company_uuid}/signatories/invite

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

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

phonestring

The signatory's phone number.

birthdaystring date

The signatory's date of birth.

emailstring email required

The signatory's email address.

ssnstring

The signatory's SSN. Required for create with complete information; not used for invite.

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