Skip to content

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:

TypeDescription
SignerReviews documents and adds a signature or initials. Every envelope must have at least one signing recipient.
ApproverReviews and approves documents without signing. Approver actions are not recorded in the audit log.
PreparerFills in document fields before signers receive the envelope. Preparer actions are not recorded in the audit log.
Automatic SignerThe signature is applied automatically by the system. No ceremony, no email.
Qualified SignerSigns 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 whenKey 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"
}