Sign an employee form

put

https://api.gusto-demo.com/v1/employees/{employee_id}/forms/{form_id}/sign

Sign an employee form.

The optional preparer attributes are only valid for I-9 form. When a preparer is used, the first name, last name, street address, city, state, and zip for that preparer are all required.

scope: employee_forms:sign

Path Params

employee_id

string

required

The UUID of the employee

form_id

string

required

The UUID of the form

Body Params

signature_text

string

required

The signature

agree

boolean

required

Whether you agree to sign electronically

signed_by_ip_address

string

The IP address of the signatory who signed the form. Both IPv4 AND IPv6 are supported. You must provide the IP address with either this parameter OR you can leave out this parameter and set the IP address in the request header using the x-gusto-client-ip header instead.

preparer

boolean

Whether there is a preparer

preparer_first_name

string

preparer_last_name

string

preparer_street_1

string

preparer_street_2

string

preparer_city

string

preparer_state

string

preparer_zip

string

preparer_agree

string

Whether preparer agrees to sign electronically

preparer2

boolean

Whether there is a 2nd preparer

preparer2_first_name

string

preparer2_last_name

string

preparer2_street_1

string

preparer2_street_2

string

preparer2_city

string

preparer2_state

string

preparer2_zip

string

preparer2_agree

string

Whether 2nd preparer agrees to sign electronically

preparer3

boolean

Whether there is a 3rd preparer

preparer3_first_name

string

preparer3_last_name

string

preparer3_street_1

string

preparer3_street_2

string

preparer3_city

string

preparer3_state

string

preparer3_zip

string

preparer3_agree

string

Whether 3rd preparer agrees to sign electronically

preparer4

boolean

Whether there is a 4th preparer

preparer4_first_name

string

preparer4_last_name

string

preparer4_street_1

string

preparer4_street_2

string

preparer4_city

string

preparer4_state

string

preparer4_zip

string

preparer4_agree

string

Whether 4th preparer agrees to sign electronically

Headers

x-gusto-client-ip

string

Optional header to supply the IP address. This can be used to supply the IP address for signature endpoints instead of the signed_by_ip_address parameter.

X-Gusto-API-Version

string

enum

Defaults to 2026-02-01

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

Allowed:

Responses

404

Not Found

The requested resource does not exist. Make sure the provided UUID is valid.

200Example response

422Unprocessable 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 guide for more details.