An envelope can carry several documents and produce more than one deliverable, which is great for flexibility but can get messy when every deliverable looks the same and contains every document. Two new properties on the deliverable object fix that.
Selecting documents
The included_documents property takes an array of document keys and restricts the deliverable to just that subset. If you send a contract bundled with a W-9 and a welcome letter, you can generate one deliverable containing only the signed contract for your legal archive and a separate deliverable with the tax form for accounting. If included_documents is omitted, the deliverable includes every document on the envelope, matching the previous behavior.
Naming deliverables
The name property sets an identifier on the deliverable that you can use to distinguish between multiple outputs on the same envelope. It’s returned on the deliverable object and surfaces in webhook events, making it much easier to route files to the right destination in your backend.
Both properties are available on the Create Deliverable endpoint. See the deliverable object docs for the full schema.
