---
title: "Change Signer (Reassign Document Recipient)"
method: POST
path: "/public/v1/documents/{id}/recipients/{recipient_id}/reassign"
tags: ["Document Recipients"]
---

# Change Signer (Reassign Document Recipient)

`POST /public/v1/documents/{id}/recipients/{recipient_id}/reassign`

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v1/documents/{id}/recipients/{recipient_id}/reassign`
- Auth: one of:
  - API key in header `Authorization`
  - OAuth 2
    - Authorization code: `https://app.pandadoc.com/oauth2/authorize`
    - Token URL: `https://api.pandadoc.com/oauth2/access_token`
- TypeScript: <https://skmtc.dev/pandadoc/apis/pandadoc-public-api/docs/public/v1/documents/:id/recipients/:recipient_id/reassign/post.ts> (a function with typed inputs; its response is checked against the schema)

Reassign fields to another signer.

> 🚧 Before you start
> 
> To change a signer in a document, please ensure that:
> 
> - You have the 'Can Manage Recipients' permission.
> - New signer is already created in your contacts. If not, add them using the [Create Contact](https://developers.pandadoc.com/reference/create-contact) endpoint.

You can reassign fields to another signer before the original signer has signed the document. You can choose any person except those recipients who have already signed the document.

The endpoint path includes the `recipient_id` of the original signer and the request body must include the following two parameters:

- `kind`: Set this parameter to `contact` to specify an individual contact, or `contact_group` to specify a contact group.
- `id`: Input the ID of the contact (for `kind: contact`) or contact group (for `kind: contact_group`) you want to use as a replacement for the original signer.

To retrieve the contact's ID, use the [List Contacts](https://developers.pandadoc.com/reference/list-contacts) endpoint to access a list of all contacts, and then locate the desired contact by searching using the name or email address within the returned list.

Once you execute the call to change the signer, the original signer will be entirely removed from the document. If you wish to retain the original signer as a CC recipient, you can re-add them using the [Add CC Recipient](https://developers.pandadoc.com/reference/add-new-recipient-cc) endpoint.

> 🚧 Pre-filled fields
> 
> If you change the signer in a document that has already been sent, the signer's pre-filled fields will be completely reset. In the 'Draft' (`document.draft`) status, pre-filled fields will remain.

## Path parameters

- `id` string, required
- `recipient_id` string, required

## Request body

- DocumentRecipientCreateRequest
  - `id` string, required: The ID of the recipient to add. - For `kind: contact` — the contact ID returned by the List Contacts endpoint. - For `kind: contact_group` — the contact group ID.
  - `kind` 'contact' | 'contact_group', required

## Response `200`

OK

- DocumentRecipientResponse
  - `recipient_id` string

## Other responses

- `400`: Bad Request
- `401`: Authentication error
- `403`: Permission error
- `404`: Not found
- `423`: Document is locked for editing
- `429`: Too Many Requests

---

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