Recipients
Recipient
The recipient object represents a person who participates in an envelope as a signer, approver, preparer, automatic signer, or qualified signer
A recipient is a person who receives and acts on an envelope. Every envelope must have at least one recipient.
Recipients have five types, each with a different role:
| Type | Description |
|---|---|
| Signer | Reviews documents and adds a signature or initials. Every envelope must have at least one signing recipient. |
| Approver | Reviews and approves documents without signing. Approver actions are not recorded in the audit log. |
| Preparer | Fills in document fields before signers receive the envelope. Preparer actions are not recorded in the audit log. |
| Automatic Signer | The signature is applied automatically by the system. No ceremony, no email. |
| Qualified Signer | Signs with a qualified electronic signature (QES) through your own trust service provider. In public beta. |
To choose between them:
Which recipient type do I need?
| Recipient type | Use when | Key rule |
|---|---|---|
signer | The person adds a signature or initials in their own ceremony. A simple electronic signature covers most business documents. | Every envelope needs at least one signing recipient. Every step of the ceremony is recorded in the audit log. |
qualified_signer | The law, a regulator or the other party requires a qualified electronic signature (QES) under eIDAS. | In public beta: you bring your own QTSP. Sequential routing, and exactly one signature place. |
automatic_signer | You have recorded authority to sign on the person's behalf. | No email and no ceremony: the signature comes from the images you provide, with a mandate. Consult your legal counsel for high-risk documents. |
approver | The person reviews and authorizes the documents, and can fill in input places, without signing. | The last button is Approve. Approver actions are not recorded in the audit log. Use sequential routing so the approver acts before the signer. |
preparer | The person fills in input places before the signers receive the envelope. | Can't add signatures or initials. The last button is Finish. Preparer actions are not recorded in the audit log. |
Each recipient participates in the envelope through a ceremony, a guided session where they complete their assigned actions. Automatic signers are the exception: they do not access a ceremony; their signature is applied automatically by the system. A recipient’s status tracks their progress through the workflow. See the recipient lifecycle for details on each status and what triggers a transition.
A recipient belongs to an envelope.
Attributes
{
"id": "re_49r1R2jpPDz8hSpP75ZkPp",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "signer",
"key": "client",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"status": "completed",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"redirect_url": null,
"redirect_delay": 3,
"embeddable_in": [],
"url_variant": "standard",
"url": null
},
"delivery_type": "email",
"ceremony_creation": "automatic",
"signature_options": [
"typed",
"drawn"
],
"completed_at": "2026-11-02T14:41:02.000Z",
"status_updated_at": "2026-11-02T14:41:02.000Z"
}{
"id": "re_1mdt9PluVuu4QIhYYe8R1P",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "approver",
"key": "hiring_manager",
"name": "Alex Chen",
"email": "alex.chen@example.com",
"status": "completed",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"redirect_url": null,
"redirect_delay": 3,
"embeddable_in": [],
"url_variant": "standard",
"url": null
},
"delivery_type": "none",
"ceremony_creation": "automatic",
"completed_at": "2026-11-02T14:30:00.000Z",
"status_updated_at": "2026-11-02T14:30:00.000Z"
}{
"id": "re_65ucNVJLuMTdsNsdZ96H3L",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "preparer",
"key": "preparer",
"name": "Sam Patel",
"email": "sam.patel@example.com",
"status": "completed",
"ceremony": {
"authentication": [
{
"type": "email_link",
"subject_override": null,
"message_override": null
}
],
"redirect_url": null,
"redirect_delay": 3,
"embeddable_in": [],
"url_variant": "standard",
"url": null
},
"delivery_type": "none",
"ceremony_creation": "automatic",
"completed_at": "2026-11-02T14:10:00.000Z",
"status_updated_at": "2026-11-02T14:10:00.000Z"
}{
"id": "re_37Z4CKAhhVglhjQXeYclOa",
"envelope_id": "eb4cf433-a8af-4161-b37b-7ef57d423e56",
"type": "automatic_signer",
"key": "company",
"name": "Acme Corp",
"signature": {
"type": "drawn",
"url": "https://api.signatureapi.com/v1/uploads/upl_3JJz6t1o8A5YjX5VpnX27Z"
},
"initials": {
"type": "drawn",
"url": "https://api.signatureapi.com/v1/uploads/upl_2tq9HtBuXZH2GSsrzJp9O7"
},
"mandate": "Authorized by Acme Corp Legal on November 2, 2026",
"status": "completed",
"status_updated_at": "2026-11-02T14:05:00.000Z",
"completed_at": "2026-11-02T14:05:00.000Z"
}