Create Unclaimed Draft

Creates a new Draft that can be claimed using the claim URL. The first authenticated user to access the URL will claim the Draft and will be shown either the "Sign and send" or the "Request signature" page with the Draft loaded. Subsequent access to the claim URL will result in a 404.

Manage accounts, signature requests, templates, teams, bulk sends, file downloads, fax, and event callbacks through the complete Dropbox Sign v3 API; the Hub provides documentation and a local SDK/CLI only.

Request

operationId: unclaimedDraftCreate
Server: https://api.hellosign.com/v3
Authentication: api_key, oauth2

Request parameters

No URL, query, or header parameters.

Request body

UnclaimedDraftCreateRequestrequired

Content-Type: application/json, multipart/form-data

Properties: filesfile_urlsallow_declineattachmentscc_email_addressesclient_idcustom_fieldsfield_optionsform_field_groupsform_field_rulesform_fields_per_documenthide_text_tagsmessagemetadatashow_progress_steppersignerssigning_optionssigning_redirect_urlsubjecttest_modetypeuse_preexisting_fieldsuse_text_tagsexpires_at

{
  "files": [
    {}
  ],
  "file_urls": [
    "https://example.com/resource"
  ],
  "allow_decline": false,
  "attachments": [
    {
      "name": "Example Name",
      "required": false,
      "signer_index": 0
    }
  ],
  "cc_email_addresses": [
    "developer@example.com"
  ],
  "client_id": "example-client-id",
  "custom_fields": [
    {
      "name": "Example Name",
      "required": false
    }
  ],
  "field_options": {
    "date_format": "MM / DD / YYYY"
  }
}

Responses

`200`

UnclaimedDraftCreateResponseapplication/json

successful operation

Properties: unclaimed_draftwarnings

`4XX`

ErrorResponseapplication/json

failed_operation

Properties: error

{
  "unclaimed_draft": {
    "signature_request_id": "example-signature-request-id",
    "claim_url": "https://example.com/resource",
    "signing_redirect_url": "https://example.com/resource",
    "requesting_redirect_url": "https://example.com/resource",
    "expires_at": 0,
    "test_mode": false
  },
  "warnings": [
    {
      "warning_name": "Example Name"
    }
  ]
}