Skip to main content
POST
Create an eSignature draft

Authorizations

x-token
string
header
required

Body

application/json

Body of draft create and edit. Pages, package documents and page settings are built from templateIds, not sent. Unlisted fields are dropped.

cardId
string
required

The card the templates are merged against.

templateIds
string[]
required

The v2 builder templates the document is built from, one package document each, in this order.

Required array length: 1 - 20 elements
recipients
object[]
required
Minimum array length: 1
from
string
required

Sender email address: one of the acting user's (or their teams') email inboxes, from GET /api/users/{userId}/inboxes. Recipients' replies go to it. Anything else is a 400.

expirationDate
string<date-time>
required

When the signing links expire.

title
string
required

Document title.

Minimum string length: 1
userId
string

The acting user. Required with an API key or partner token.

message
string

Default: the first template's message, merged.

orderEnabled
boolean

Whether signers sign in order. Default false.

accessType
string

private limits the document to userIds. Default: the first template's, else public.

userIds
string[]

Default: the first template's, else the acting user.

assignee
string
folderId
string

Default: the first template's.

revisionOf
string

Edit & Resend: the sent document this one replaces.

leaseDetails
any

Response

The new draft.

data
object