POST | /FormFiller/Send | Send the template(s) to invitees to start a We Sign process | Send a template for filling and signing |
---|
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Templates | model | array | Yes | Collection of forms to be sent, if an account reference is not supplied for the forms, the forms will be associated with your api account. |
DueDate | model | string | No | Due date that forms are to be signed by. If not set, +14 days is the default |
GMT | model | string | No | GMT Offset |
Embedded | model | boolean | No | Shows if embedded signing |
ReturnUrl | model | string | No | Return Url |
Sequential | model | boolean | No | If all signers need to sign one by one with the order in template.signers |
NotifyUrl | model | string | No | Notify Url |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | form | string | Yes | Template name |
Reference | form | string | Yes | Identifier |
Signers | form | array | Yes | List of signers required for the template |
Fields | form | array | Yes | List of fields required for the template |
ClientReference | form | string | No | client side referese; e.g. external id etc. |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
SignerReference | form | string | No | Signer reference |
IsFaceToFaceSigning | form | bool | No | |
VideoConfirmationEnabled | form | bool | No | |
ReviewBeforeSigningEnabled | form | bool | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
MobileNumber | form | string | No | Mobile number of signer, for SMS secured forms. Must include the mobile carrier code e.g. Australia 04, New Zealand 027 or 021 etc |
MobileCountry | form | string | No | Mobile Country code for phone number e.g. Australia 61, New Zealand 64 etc |
ShareUsers | form | List<ShareUser> | No | |
ClientReference | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
FirstName | form | string | Yes | First name of user |
MiddleName | form | string | No | Middle name of user |
LastName | form | string | Yes | Last name of user |
form | string | Yes | Email address of user |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
IsDefault | form | bool | No | |
IsOwner | form | bool | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Label | form | string | Yes | Field label |
Value | form | string | Yes | Field value |
FieldType | form | string | Yes | Field typeAllowable Values
|
IsRequired | form | boolean | Yes | If field is mandatory |
ID | form | string | Yes | Field reference; Obsolated, use Reference instead. |
Reference | form | string | Yes | Field reference; |
ReadOnly | form | boolean | Yes | If field is readonly |
ClientField | form | boolean | Yes | Field name on client side |
Name | Value | |
---|---|---|
Text | 0 | |
MultiLineText | 1 | |
CheckBox | 3 | |
RadioButton | 4 | |
DropDownList | 5 | |
DateInput | 6 |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
QueueReference | form | string | No | |
PackageReference | form | string | No | |
PackageName | form | string | No | |
PackageStatus | form | string | No | |
Documents | form | List<DocumentResponse> | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | form | string | Yes | File Name |
FormDirectReference | form | string | No | Form reference |
Signers | form | array | Yes | List of signers |
Status | form | string | No | Document signing statusAllowable Values
|
DueDate | form | string | No | Due Date of document |
GMT | form | string | No | GMT Offset |
LastSignedDate | form | string | No | Date of latest signature |
Folder | form | string | No | The folder of the documentAllowable Values
|
Logs | form | array | No | Document logs |
HasFileUploaded | form | boolean | No | Whether invitee uploaded any files during signing process. |
PackageReference | form | string | No | Package reference |
ClientReference | form | string | No | client side referese; e.g. external id etc. |
EditUrl | form | string | No | |
IDVerificationRequested | form | bool | No | ID Verification requested. |
MatterNumber | form | string | No | Matter Number |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Reference | form | string | Yes | Document reference, used for document access |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
HasSigned | form | boolean | No | User signing status |
Editable | form | boolean | No | Signer name and email can be updated by Calling UpdateSigner |
SignedStatus | form | boolean | No | Signer StatusAllowable Values
|
DeclinedReason | form | string | No | Declined reason. Return only when invitee declined to sign. |
VideoConfirmationDetail | form | VideoConfirmationDetail | No | |
IDCheckStatus | form | string | No | |
IDVerificationStatus | form | string | No | |
IDVerificationResult | form | string | No | |
IDVerificationFaceMatchResult | form | string | No | |
IDVerificationLivenessResult | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
SigningKey | form | string | No | Url for access to signing; Only when this is an embedded signer |
Initialized | |
Invitation | |
Reminder1 | |
Reminder2 | |
AutoExtend | |
Expired | |
Signed | |
Complete | |
Archived | |
Pending | |
Deleted | |
Rejected | |
Declined | |
Reminder |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | form | string | No | |
ShortUrl | form | string | No | |
IsVideoReady | form | bool | No | |
Password | form | string | No | |
form | string | No | ||
IsWitness | form | bool | No | |
IsVideoDisabled | form | bool | No | |
IsVideoOptOut | form | bool | No | |
WitnessOwner | form | string | No |
Name | Parameter | Data Type | Required | Description |
---|---|---|---|---|
Name | form | string | No | Name of user responsible for action |
Action | form | string | No | Log entry |
Date | form | string | No | Date of log entry |
GMT | form | string | No | GMT Offset |
Role | form | string | No | Role of user responsible for action |
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /FormFiller/Send HTTP/1.1
Host: api.securedsigning.com
Accept: application/json
Content-Type: application/json
Content-Length: length
{"Templates":[{"Name":"String","Reference":"String","Signers":[{"SignerReference":"String","IsFaceToFaceSigning":false,"VideoConfirmationEnabled":false,"ReviewBeforeSigningEnabled":false,"MobileNumber":"String","MobileCountry":"String","ShareUsers":[{"IsDefault":false,"IsOwner":false,"FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"ClientReference":"String","FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"Fields":[{"Label":"String","Value":"String","FieldType":"Text","IsRequired":false,"ID":"String","Reference":"String","ReadOnly":false,"ClientField":"String"}],"ClientReference":"String"}],"DueDate":"String","GMT":"String","Embedded":false,"ReturnUrl":"String","Sequential":false,"NotifyUrl":"String"}
HTTP/1.1 200 OK Content-Type: application/json Content-Length: length {"QueueReference":"String","PackageReference":"String","PackageName":"String","PackageStatus":"String","Documents":[{"Name":"String","FormDirectReference":"String","Signers":[{"HasSigned":false,"Editable":false,"SignedStatus":"Initialized","DeclinedReason":"String","VideoConfirmationDetail":{"Name":"String","ShortUrl":"String","IsVideoReady":false,"Password":"String","Email":"String","IsWitness":false,"IsVideoDisabled":false,"IsVideoOptOut":false,"WitnessOwner":"String"},"IDCheckStatus":"String","IDVerificationStatus":"String","IDVerificationResult":"String","IDVerificationFaceMatchResult":"String","IDVerificationLivenessResult":"String","SigningKey":"String","SignerReference":"String","IsFaceToFaceSigning":false,"VideoConfirmationEnabled":false,"ReviewBeforeSigningEnabled":false,"MobileNumber":"String","MobileCountry":"String","ShareUsers":[{"IsDefault":false,"IsOwner":false,"FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"ClientReference":"String","FirstName":"String","MiddleName":"String","LastName":"String","Email":"String"}],"Status":"String","DueDate":"String","GMT":"String","LastSignedDate":"String","Folder":"String","Logs":[{"Name":"String","Action":"String","Date":"String","GMT":"String","Role":"String"}],"HasFileUploaded":false,"PackageReference":"String","ClientReference":"String","EditUrl":"String","IDVerificationRequested":false,"MatterNumber":"String","Reference":"String"}]}