Differentiate distribution method on specific recipients
Author: TC-43Created Jul 29, 2026Updated Sep 18, 2026
Labelsstatus: review needed
Feature Description
Allow API-created envelopes to specify the distribution method per-recipient. The current behaviour specifies the distribution method at envelope level, and that is shared by all recipients. For mobile app embedded workflows, this may be a limiting factor.
Use Case
A document must be signed by two classes of signer:
- Approving signer - whoever takes responsibility for the document's content in case of dispute, e.g. customer, plant manager, function manager. Requires (at least weak) authentication, e.g. 2FA via e-mail OTP.
- Document owner - can sign directly in-app while generating the document, via an embedded browser that redirects to the Documenso-generated link.
This affects digitalized workflows that require document signing, e.g. B2B field service.
Proposed Solution
Add a distributionMethod field to payload.recipients on
POST /envelope/create
that overrides the envelope-defined distribution method for a specific recipient.
Alternatives (optional)
No response
Additional Context
No response
Please check the boxes that apply to this feature request.
- I have searched the existing feature requests to make sure this is not a duplicate.
- I have provided a detailed description of the requested feature.
- I have explained the use case or scenario for this feature.
- I have included any relevant technical details or design suggestions.
- I understand that this is a suggestion and that there is no guarantee of implementation.
Source: documenso/documenso