---
title: "Create Docusign Envelope From Draft"
method: POST
path: "/calls/{call_id}/docusign-drafts/{draft_id}/envelope"
tags: ["Calls"]
---

# Create Docusign Envelope From Draft

`POST /calls/{call_id}/docusign-drafts/{draft_id}/envelope`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/calls/{call_id}/docusign-drafts/{draft_id}/envelope`
- Auth: none declared
- TypeScript: <https://skmtc.dev/openintake/apis/openintake-api/docs/calls/:call_id/docusign-drafts/:draft_id/envelope/post.ts> (a function with typed inputs; its response is checked against the schema)

Create the DocuSign draft envelope with the values on the fill page.

Nothing is sent to the client: the envelope is a DocuSign draft that
staff review and send from DocuSign. The intake's earlier unsent draft
envelope (a template staff switched away from) is deleted from DocuSign.

## Path parameters

- `call_id` string, uuid, required
- `draft_id` string, uuid, required

## Response `200`

Successful Response

- CallDocuSignDraftResponse: A template staff are filling from an intake call (the fill page).
  - `docusign_form_draft_id` string, uuid, required
  - `call_id` string, uuid, required
  - `docusign_form_id` string, uuid, nullable
  - `template_name` string, nullable
  - `status` string, required
  - `error` string, nullable
  - `recipient_name` string, nullable
  - `recipient_email` string, nullable
  - `fields` DocuSignDraftField[]
    - `tab_label` string, required
    - `display_name` string, required
    - `description` string, nullable
    - `input_kind` string, required
    - `section` string, nullable
    - `address_group` string, nullable
    - `required` boolean
    - `max_length` integer, nullable
    - `value` unknown
    - `ai_value` unknown
  - `placeholder_recipient_email` string, nullable
  - `docusign_envelope_id` string, uuid, nullable
  - `envelope_status` string, nullable
  - `envelope_created_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-04** `949d5527a74f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/calls/:call_id/docusign-drafts/:draft_id/envelope/post.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/fe9f779e77ad?raw)