Box Sign request (Base)
A standard representation of a signature request object.
Members
are_reminders_enabled :boolean
Reminds signers to sign a document on day 3, 8, 13 and 18. Reminders are only sent to outstanding signers.
Example: true
Type:
- boolean
are_text_signatures_enabled :boolean
Disables the usage of signatures generated by typing (text).
Example: true
Type:
- boolean
- Default Value:
- true
- Source:
days_valid :number
Set the number of days after which the created signature request will automatically expire if not completed. By default, we do not apply any expiration date on signature requests, and the signature request does not expire.
Example: 2
Type:
- number
declined_redirect_url :string
The uri that a signer will be redirected to after declining to sign a document.
Example: https://declined-redirect.com
Type:
- string
email_message :string
Message to include in sign request email. The field is cleaned through sanitization of specific characters. However, some html tags are allowed. Links included in the message are also converted to hyperlinks in the email. The message may contain the following html tags including `a`, `abbr`, `acronym`, `b`, `blockquote`, `code`, `em`, `i`, `ul`, `li`, `ol`, and `strong`. Be aware that when the text to html ratio is too high, the email may end up in spam filters. Custom styles on these tags are not allowed. If this field is not passed, a default message will be used.
Example: Hello! Please sign the document below
Type:
- string
email_subject :string
Subject of sign request email. This is cleaned by sign request. If this field is not passed, a default subject will be used.
Example: Sign Request from Acme
Type:
- string
external_id :string
This can be used to reference an ID in an external system that the sign request is related to.
Example: 123
Type:
- string
external_system_name :string
Used as an optional system name to appear in the signature log next to the signers who have been assigned the `embed_url_external_id`.
Example: Box
Type:
- string
is_document_preparation_needed :boolean
Indicates if the sender should receive a `prepare_url` in the response to complete document preparation using the UI.
Example: true
Type:
- boolean
is_phone_verification_required_to_view :boolean
Forces signers to verify a text message prior to viewing the document. You must specify the phone number of signers to have this setting apply to them.
Example: true
Type:
- boolean
name :string
Name of the signature request.
Example: name
Type:
- string
prefill_tags :Array
When a document contains sign-related tags in the content, you can prefill them using this `prefill_tags` by referencing the 'id' of the tag as the `external_id` field of the prefill tag.
Type:
- Array
redirect_url :string
When specified, the signature request will be redirected to this url when a document is signed.
Example: https://www.example.com
Type:
- string
template_id :string
When a signature request is created from a template this field will indicate the id of that template.
Example: 123075213-af2c8822-3ef2-4952-8557-52d69c2fe9cb
Type:
- string