Class UnclaimedDraftCreateRequest


  • @Generated("org.openapitools.codegen.languages.JavaClientCodegen")
    public class UnclaimedDraftCreateRequest
    extends java.lang.Object
    UnclaimedDraftCreateRequest
    • Field Detail

      • JSON_PROPERTY_TYPE

        public static final java.lang.String JSON_PROPERTY_TYPE
        See Also:
        Constant Field Values
      • JSON_PROPERTY_FILE

        public static final java.lang.String JSON_PROPERTY_FILE
        See Also:
        Constant Field Values
      • JSON_PROPERTY_FILE_URL

        public static final java.lang.String JSON_PROPERTY_FILE_URL
        See Also:
        Constant Field Values
      • JSON_PROPERTY_ALLOW_DECLINE

        public static final java.lang.String JSON_PROPERTY_ALLOW_DECLINE
        See Also:
        Constant Field Values
      • JSON_PROPERTY_ATTACHMENTS

        public static final java.lang.String JSON_PROPERTY_ATTACHMENTS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_CC_EMAIL_ADDRESSES

        public static final java.lang.String JSON_PROPERTY_CC_EMAIL_ADDRESSES
        See Also:
        Constant Field Values
      • JSON_PROPERTY_CLIENT_ID

        public static final java.lang.String JSON_PROPERTY_CLIENT_ID
        See Also:
        Constant Field Values
      • JSON_PROPERTY_CUSTOM_FIELDS

        public static final java.lang.String JSON_PROPERTY_CUSTOM_FIELDS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_FIELD_OPTIONS

        public static final java.lang.String JSON_PROPERTY_FIELD_OPTIONS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_FORM_FIELD_GROUPS

        public static final java.lang.String JSON_PROPERTY_FORM_FIELD_GROUPS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_FORM_FIELD_RULES

        public static final java.lang.String JSON_PROPERTY_FORM_FIELD_RULES
        See Also:
        Constant Field Values
      • JSON_PROPERTY_FORM_FIELDS_PER_DOCUMENT

        public static final java.lang.String JSON_PROPERTY_FORM_FIELDS_PER_DOCUMENT
        See Also:
        Constant Field Values
      • JSON_PROPERTY_HIDE_TEXT_TAGS

        public static final java.lang.String JSON_PROPERTY_HIDE_TEXT_TAGS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_MESSAGE

        public static final java.lang.String JSON_PROPERTY_MESSAGE
        See Also:
        Constant Field Values
      • JSON_PROPERTY_METADATA

        public static final java.lang.String JSON_PROPERTY_METADATA
        See Also:
        Constant Field Values
      • JSON_PROPERTY_SHOW_PROGRESS_STEPPER

        public static final java.lang.String JSON_PROPERTY_SHOW_PROGRESS_STEPPER
        See Also:
        Constant Field Values
      • JSON_PROPERTY_SIGNERS

        public static final java.lang.String JSON_PROPERTY_SIGNERS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_SIGNING_OPTIONS

        public static final java.lang.String JSON_PROPERTY_SIGNING_OPTIONS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_SIGNING_REDIRECT_URL

        public static final java.lang.String JSON_PROPERTY_SIGNING_REDIRECT_URL
        See Also:
        Constant Field Values
      • JSON_PROPERTY_SUBJECT

        public static final java.lang.String JSON_PROPERTY_SUBJECT
        See Also:
        Constant Field Values
      • JSON_PROPERTY_TEST_MODE

        public static final java.lang.String JSON_PROPERTY_TEST_MODE
        See Also:
        Constant Field Values
      • JSON_PROPERTY_USE_PREEXISTING_FIELDS

        public static final java.lang.String JSON_PROPERTY_USE_PREEXISTING_FIELDS
        See Also:
        Constant Field Values
      • JSON_PROPERTY_USE_TEXT_TAGS

        public static final java.lang.String JSON_PROPERTY_USE_TEXT_TAGS
        See Also:
        Constant Field Values
    • Constructor Detail

      • UnclaimedDraftCreateRequest

        public UnclaimedDraftCreateRequest()
    • Method Detail

      • getType

        @Nonnull
        public UnclaimedDraftCreateRequest.TypeEnum getType()
        The type of unclaimed draft to create. Use `send_document` to create a claimable file, and `request_signature` for a claimable signature request. If the type is `request_signature` then signers name and email_address are not optional.
        Returns:
        type
      • getFile

        @Nullable
        public java.util.List<java.io.File> getFile()
        Use `file[]` to indicate the uploaded file(s) to send for signature. This endpoint requires either **file** or **file_url[]**, but not both.
        Returns:
        file
      • setFile

        public void setFile​(java.util.List<java.io.File> file)
      • getFileUrl

        @Nullable
        public java.util.List<java.lang.String> getFileUrl()
        Use `file_url[]` to have HelloSign download the file(s) to send for signature. This endpoint requires either **file** or **file_url[]**, but not both.
        Returns:
        fileUrl
      • setFileUrl

        public void setFileUrl​(java.util.List<java.lang.String> fileUrl)
      • getAllowDecline

        @Nullable
        public java.lang.Boolean getAllowDecline()
        Allows signers to decline to sign a document if `true`. Defaults to `false`.
        Returns:
        allowDecline
      • setAllowDecline

        public void setAllowDecline​(java.lang.Boolean allowDecline)
      • getAttachments

        @Nullable
        public java.util.List<SubAttachment> getAttachments()
        A list describing the attachments
        Returns:
        attachments
      • setAttachments

        public void setAttachments​(java.util.List<SubAttachment> attachments)
      • getCcEmailAddresses

        @Nullable
        public java.util.List<java.lang.String> getCcEmailAddresses()
        The email addresses that should be CCed.
        Returns:
        ccEmailAddresses
      • setCcEmailAddresses

        public void setCcEmailAddresses​(java.util.List<java.lang.String> ccEmailAddresses)
      • getClientId

        @Nullable
        public java.lang.String getClientId()
        Client id of the app used to create the draft. Used to apply the branding and callback url defined for the app.
        Returns:
        clientId
      • setClientId

        public void setClientId​(java.lang.String clientId)
      • getCustomFields

        @Nullable
        public java.util.List<SubCustomField> getCustomFields()
        When used together with merge fields, `custom_fields` allows users to add pre-filled data to their signature requests. Pre-filled data can be used with \"send-once\" signature requests by adding merge fields with `form_fields_per_document` or [Text Tags](https://app.hellosign.com/api/textTagsWalkthrough#TextTagIntro) while passing values back with `custom_fields` together in one API call. For using pre-filled on repeatable signature requests, merge fields are added to templates in the HelloSign UI or by calling [/template/create_embedded_draft](/api/reference/operation/templateCreateEmbeddedDraft) and then passing `custom_fields` on subsequent signature requests referencing that template.
        Returns:
        customFields
      • setCustomFields

        public void setCustomFields​(java.util.List<SubCustomField> customFields)
      • getFieldOptions

        @Nullable
        public SubFieldOptions getFieldOptions()
        Get fieldOptions
        Returns:
        fieldOptions
      • setFieldOptions

        public void setFieldOptions​(SubFieldOptions fieldOptions)
      • getFormFieldGroups

        @Nullable
        public java.util.List<SubFormFieldGroup> getFormFieldGroups()
        Group information for fields defined in `form_fields_per_document`. String-indexed JSON array with `group_label` and `requirement` keys. `form_fields_per_document` must contain fields referencing a group defined in `form_field_groups`.
        Returns:
        formFieldGroups
      • setFormFieldGroups

        public void setFormFieldGroups​(java.util.List<SubFormFieldGroup> formFieldGroups)
      • getFormFieldRules

        @Nullable
        public java.util.List<SubFormFieldRule> getFormFieldRules()
        Conditional Logic rules for fields defined in `form_fields_per_document`.
        Returns:
        formFieldRules
      • setFormFieldRules

        public void setFormFieldRules​(java.util.List<SubFormFieldRule> formFieldRules)
      • getFormFieldsPerDocument

        @Nullable
        public java.util.List<SubFormFieldsPerDocumentBase> getFormFieldsPerDocument()
        The fields that should appear on the document, expressed as an array of objects. (We're currently fixing a bug where this property only accepts a two-dimensional array. You can read about it here: <a href=\"/docs/placing-fields/form-fields-per-document\" target=\"_blank\">Using Form Fields per Document</a>.) **NOTE**: Fields like **text**, **dropdown**, **checkbox**, **radio**, and **hyperlink** have additional required and optional parameters. Check out the list of [additional parameters](/api/reference/constants/#form-fields-per-document) for these field types. * Text Field use `SubFormFieldsPerDocumentText` * Dropdown Field use `SubFormFieldsPerDocumentDropdown` * Hyperlink Field use `SubFormFieldsPerDocumentHyperlink` * Checkbox Field use `SubFormFieldsPerDocumentCheckbox` * Radio Field use `SubFormFieldsPerDocumentRadio` * Signature Field use `SubFormFieldsPerDocumentSignature` * Date Signed Field use `SubFormFieldsPerDocumentDateSigned` * Initials Field use `SubFormFieldsPerDocumentInitials` * Text Merge Field use `SubFormFieldsPerDocumentTextMerge` * Checkbox Merge Field use `SubFormFieldsPerDocumentCheckboxMerge`
        Returns:
        formFieldsPerDocument
      • getHideTextTags

        @Nullable
        public java.lang.Boolean getHideTextTags()
        Send with a value of `true` if you wish to enable automatic Text Tag removal. Defaults to `false`. When using Text Tags it is preferred that you set this to `false` and hide your tags with white text or something similar because the automatic removal system can cause unwanted clipping. See the [Text Tags](https://app.hellosign.com/api/textTagsWalkthrough#TextTagIntro) walkthrough for more details.
        Returns:
        hideTextTags
      • setHideTextTags

        public void setHideTextTags​(java.lang.Boolean hideTextTags)
      • getMessage

        @Nullable
        public java.lang.String getMessage()
        The custom message in the email that will be sent to the signers.
        Returns:
        message
      • setMessage

        public void setMessage​(java.lang.String message)
      • getMetadata

        @Nullable
        public java.util.Map<java.lang.String,​java.lang.Object> getMetadata()
        Key-value data that should be attached to the signature request. This metadata is included in all API responses and events involving the signature request. For example, use the metadata field to store a signer's order number for look up when receiving events for the signature request. Each request can include up to 10 metadata keys (or 50 nested metadata keys), with key names up to 40 characters long and values up to 1000 characters long.
        Returns:
        metadata
      • setMetadata

        public void setMetadata​(java.util.Map<java.lang.String,​java.lang.Object> metadata)
      • getShowProgressStepper

        @Nullable
        public java.lang.Boolean getShowProgressStepper()
        When only one step remains in the signature request process and this parameter is set to `false` then the progress stepper will be hidden.
        Returns:
        showProgressStepper
      • setShowProgressStepper

        public void setShowProgressStepper​(java.lang.Boolean showProgressStepper)
      • getSigners

        @Nullable
        public java.util.List<SubUnclaimedDraftSigner> getSigners()
        Add Signers to your Unclaimed Draft Signature Request.
        Returns:
        signers
      • getSigningOptions

        @Nullable
        public SubSigningOptions getSigningOptions()
        Get signingOptions
        Returns:
        signingOptions
      • setSigningOptions

        public void setSigningOptions​(SubSigningOptions signingOptions)
      • getSigningRedirectUrl

        @Nullable
        public java.lang.String getSigningRedirectUrl()
        The URL you want signers redirected to after they successfully sign.
        Returns:
        signingRedirectUrl
      • setSigningRedirectUrl

        public void setSigningRedirectUrl​(java.lang.String signingRedirectUrl)
      • getSubject

        @Nullable
        public java.lang.String getSubject()
        The subject in the email that will be sent to the signers.
        Returns:
        subject
      • setSubject

        public void setSubject​(java.lang.String subject)
      • getTestMode

        @Nullable
        public java.lang.Boolean getTestMode()
        Whether this is a test, the signature request created from this draft will not be legally binding if set to `true`. Defaults to `false`.
        Returns:
        testMode
      • setTestMode

        public void setTestMode​(java.lang.Boolean testMode)
      • getUsePreexistingFields

        @Nullable
        public java.lang.Boolean getUsePreexistingFields()
        Set `use_text_tags` to `true` to enable [Text Tags](https://app.hellosign.com/api/textTagsWalkthrough#TextTagIntro) parsing in your document (defaults to disabled, or `false`). Alternatively, if your PDF contains pre-defined fields, enable the detection of these fields by setting the `use_preexisting_fields` to `true` (defaults to disabled, or `false`). Currently we only support use of either `use_text_tags` or `use_preexisting_fields` parameter, not both.
        Returns:
        usePreexistingFields
      • setUsePreexistingFields

        public void setUsePreexistingFields​(java.lang.Boolean usePreexistingFields)
      • getUseTextTags

        @Nullable
        public java.lang.Boolean getUseTextTags()
        Set `use_text_tags` to `true` to enable [Text Tags](https://app.hellosign.com/api/textTagsWalkthrough#TextTagIntro) parsing in your document (defaults to disabled, or `false`). Alternatively, if your PDF contains pre-defined fields, enable the detection of these fields by setting the `use_preexisting_fields` to `true` (defaults to disabled, or `false`). Currently we only support use of either `use_text_tags` or `use_preexisting_fields` parameter, not both.
        Returns:
        useTextTags
      • setUseTextTags

        public void setUseTextTags​(java.lang.Boolean useTextTags)
      • equals

        public boolean equals​(java.lang.Object o)
        Return true if this UnclaimedDraftCreateRequest object is equal to o.
        Overrides:
        equals in class java.lang.Object
      • hashCode

        public int hashCode()
        Overrides:
        hashCode in class java.lang.Object
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object
      • createFormData

        public java.util.Map<java.lang.String,​java.lang.Object> createFormData()
                                                                              throws ApiException
        Throws:
        ApiException