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

# Add Document Recipient

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

## Request

- Base URL: `https://api.pandadoc.com`
- URL: `https://api.pandadoc.com/public/v1/documents/{id}/recipients`
- 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/post.ts> (a function with typed inputs; its response is checked against the schema)

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, or `contact_group` to specify a contact group.
- `id`:  Input the ID of the desired contact (for `kind: contact`) or contact group (for `kind: contact_group`).

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: 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)