---
title: "Add Document Recipient"
method: POST
path: "/public/v1/documents/{id}/recipients"
tags: ["Document Recipients"]
---

# Add Document Recipient

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

Add a CC recipient to a document.

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

To add a new CC recipient to a document, two parameters must be included in the request body:

- `kind`: Set this parameter to `contact` to specify an individual contact.
- `id`:  Input the ID of the desired contact.

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.

### Document status

You can add CC recipients in any document status except for the 'Expired' (`document.voided`) and 'Declined' (`document.declined`).

> 📘 Email notification to access the document
> 
> **Note**: When a document is in one of the following statuses: 'Sent' (`document.sent`), 'Viewed' (`document.viewed`), 'Completed' (`document.completed`), 'Waiting for Payment' (`document.waiting_pay`), or 'Paid' (`document.paid`), any added CC recipient will receive an instant notification at their email address, allowing them access to the document.

## Path parameters

- `id` string, required

## Request body

- DocumentRecipientCreateRequest
  - `id` string, required — Contact uuid.
  - `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.net/pandadoc/apis/pandadoc-public-api.md) · [All operations](https://skmtc.net/pandadoc/apis/pandadoc-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pandadoc/pandadoc-public-api/versions/0c2b70be3fb0/schema)