---
title: "Invite a signatory"
method: POST
path: "/v1/companies/{company_uuid}/signatories/invite"
tags: ["Signatories"]
---

# Invite a signatory

`POST /v1/companies/{company_uuid}/signatories/invite`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/signatories/invite`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_uuid/signatories/invite/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a signatory with minimal information. This signatory can be invited to provide more information through the [Update a signatory](ref:put-v1-companies-company_uuid-signatories-signatory_uuid) endpoint. This will start the identity verification process and allow the signatory to be verified to sign documents.

## Related guides
- [Signatory Events](doc:signatory-events)

scope: `signatories:manage`

## Path parameters

- `company_uuid` string, required

## Headers

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

## Request body

- SignatoryInviteRequest: Request body for inviting a signatory.
  - `first_name` string, required: The signatory's first name.
  - `middle_initial` string
  - `last_name` string, required: The signatory's last name.
  - `title` string: The signatory's title (e.g. CEO, President).
  - `phone` string: The signatory's phone number.
  - `birthday` string, date: The signatory's date of birth.
  - `email` string, email, required: The signatory's email address.
  - `ssn` string: The signatory's SSN. Required for create with complete information; not used for invite.
  - `home_address` object: The signatory's home address.
    - `street_1` string
    - `street_2` string
    - `city` string
    - `state` string
    - `zip` string
    - `country` string

## Response `200`

Successful

- Signatory: The representation of a company's signatory
  - `uuid` string, required
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `title` string, nullable
  - `phone` string, nullable
  - `email` string
  - `birthday` string, nullable
  - `is_admin` boolean: Whether or not the signatory is also the payroll admin of the company.
  - `has_ssn` boolean: Indicates whether the signatory has an SSN in Gusto.
  - `version` string: The current version of the signatory. See the [versioning guide](https://docs.gusto.com/embedded-payroll/docs/idempotency) for information on how to use this field.
  - `identity_verification_status` 'Pass' | 'Fail' | 'Skipped', nullable: | | | |---|---| |__Status__| __Description__ | | Pass | Signatory can sign all forms | | Fail | Signatory cannot sign forms | | Skipped | Signatory cannot sign Form 8655 until the form is manually uploaded as wet-signed | | null | Identity verification process has not been completed |
  - `home_address` object, nullable
    - `street_1` string
    - `street_2` string
    - `city` string
    - `state` string
    - `zip` string
    - `country` string

## Other responses

- `404`: Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422`: Unprocessable 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](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)