test_mode optional
Whether this is a test, the signature request created from this draft will not be legally binding if set to 1. Defaults to 0.
client_id
Client id of the app you're using to create this draft. Visit our
embedded page to learn more about this parameter.
template_id or template_ids[%i%]
Use template_id to create a request from a single Template. Use template_ids[%i%] to create a request from multiple templates, where %i% is an integer indicating the order in which the template will be used. Only template_id or template_ids[%i%] can be used, not both.
requester_email_address
The email address of the user that should be designated as the requester of this draft, if the draft type is "request_signature."
title optional
The title you want to assign to the SignatureRequest.
subject optional
The subject in the email that will be sent to the signers.
message optional
The custom message in the email that will be sent to the signers.
signers[%RoleName%][name]
The name of the signer filling the role of RoleName. RoleName is case-sensitive.
signers[%RoleName%][email_address]
The email address of the signer filling the role of RoleName. RoleName is case-sensitive.
ccs[%RoleName%][email_address]
optional
The email address of the CC filling the role of RoleName. Required when a CC role exists for the Template. RoleName is case-sensitive.
signing_redirect_url optional
The URL you want the signer redirected to after they successfully sign.
requesting_redirect_url optional
The URL you want signers redirected to after they successfully request a signature.
is_for_embedded_signing optional
[boolean] The request created from this draft will also be signable in embedded mode if set to 1. Defaults to 0.
metadata[%key%] optional
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, with key names up to 40 characters long and values up to 1000 characters long.
custom_fields optional
A JSON array defining values for custom fields. Required when a custom field exists in the Template.
- name: the name, or "Field Label," of the custom field (the field's API ID can be used here as well)
- value: the value of the custom field
- editor: the RoleName allowed to edit the custom field (optional, but required if 'required' is defined)
Note: Editable custom_fields are only supported for single signer requests. If more than one signer is assigned to the request any editor value is ignored and the field will not be editable. - required: a boolean describing if this field is required (default: false).
custom_fields[%CustomFieldName%]
optional DEPRECATED
The value that will be used to populate the Custom Field with the name of CustomFieldName. The CustomFieldName is the case-sensitive "Field Label" assigned to the field when creating the template. The field's API ID can be used here as well. If the custom field is a checkbox, the value "true" indicates that it is checked by default.
file[] or file_url[] optional
Append additional files to the signature request. HelloSign will parse the files for
text tags. Text tags for signers not on the template will be ignored.
Use
file[] to pass the uploaded file(s). Use
file_url[] to have HelloSign download the file(s). We currently only support use of either the
file[] parameter or
file_url[] parameter, not both.
skip_me_now optional
Disables the "Me (Now)" option for the person preparing the document. Defaults to 0.
allow_decline optional
Allows signers to decline to sign a document if set to 1. Defaults to 0.
allow_reassign optional
Allows signers to reassign their signature requests to other signers if set to 1. Defaults to 0. Note: Only available for Gold plan and higher.
hold_request optional
The request from this draft will not automatically send to signers post-claim
if set to 1. Requester must
release
the request from hold when ready to send. Defaults to 0.
signing_options optional
This allows the requester to specify the types allowed for creating a signature.
- draw: [boolean] allows drawing the signature (default: false)
- type: [boolean] allows typing the signature (default: false)
- upload: [boolean] allows uploading the signature (default: false)
- phone: [boolean] allows using a smartphone to email the signature (default: false)
- default: the default type shown (limited to the above types) (required if signing_options defined)
If signing_options are not defined in the request, the allowed types will default to those specified in the account settings.