---
title: "Add signatory"
method: POST
path: "/documents/{document}/signatories"
tags: ["Document Operations"]
---

# Add signatory

`POST /documents/{document}/signatories`

<small>Requires an API token with the **Document Manager** role.</small>

Adds a [signatory](/#signatories) to a [document](/#documents).

> **Note:** When adding a signatory whose email corresponds to an existing user in the current fynk account,
> only `party_uuid` and `email` are required. Any additional fields (`first_name`, `last_name`, `mobile_phone`,
> `title`) will be ignored and the signatory information will be populated from the existing user's profile.

## Path parameters

- `document` string, required

## Request body

- StoreSignatoryRequest
  - `party_uuid` string, uuid, required — UUID of the [party](/#parties) the signatory will be signing for
  - `email` string, email, required — The signatory's email address
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `mobile_phone` string, nullable — Mobile phone number, in E.164 format, as shown in the example
  - `title` string, nullable

## Response `201`

`SignatoryResource`

- object
  - `data` SignatoryResource, required
    - `uuid` string, required
    - `first_name` string, nullable, required
    - `last_name` string, nullable, required
    - `email` string, nullable, required
    - `mobile_phone` string, nullable, required — Mobile phone number, in E.164 format
    - `title` string, nullable, required
    - `profile_photo_url` string, nullable, required
    - `signing_order` integer, nullable, required — When sequential signing is enabled, signatories will sign in ascending order of their `signing_order`
    - `has_account_user` boolean, required — `true` if the signatory has a fynk user belonging to your account
    - `party_uuid` string, nullable, required — UUID of the party that the signatory signs for

## Other responses

- `401` — Unauthenticated
- `403` — Authorization error
- `404` — Not found
- `409` — The resource's current state prevents the requested change
- `422` — Validation error

---

[API](https://skmtc.dev/fynk/apis/fynk-api-reference.md) · [All operations](https://skmtc.dev/fynk/apis/fynk-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fynk/fynk-api-reference/revisions/9657a6757f59/schema)