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 .xml suffix or ?format=xml
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/xml
Content-Type: application/xml
Content-Length: length
<SendFormFillerRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SecuredSigning.Api.Rest.Requests">
<DueDate>String</DueDate>
<Embedded>false</Embedded>
<GMT>String</GMT>
<NotifyUrl>String</NotifyUrl>
<ReturnUrl>String</ReturnUrl>
<Sequential>false</Sequential>
<Templates xmlns:d2p1="http://schemas.datacontract.org/2004/07/SecuredSigning.Api.Rest.Models">
<d2p1:FormFillerTemplate>
<d2p1:ClientReference>String</d2p1:ClientReference>
<d2p1:Fields>
<d2p1:FormFillerField>
<d2p1:ClientField>String</d2p1:ClientField>
<d2p1:FieldType>Text</d2p1:FieldType>
<d2p1:ID>String</d2p1:ID>
<d2p1:IsRequired>false</d2p1:IsRequired>
<d2p1:Label>String</d2p1:Label>
<d2p1:ReadOnly>false</d2p1:ReadOnly>
<d2p1:Reference>String</d2p1:Reference>
<d2p1:Value>String</d2p1:Value>
</d2p1:FormFillerField>
</d2p1:Fields>
<d2p1:Name>String</d2p1:Name>
<d2p1:Reference>String</d2p1:Reference>
<d2p1:Signers>
<d2p1:Signer>
<d2p1:Email>String</d2p1:Email>
<d2p1:FirstName>String</d2p1:FirstName>
<d2p1:LastName>String</d2p1:LastName>
<d2p1:MiddleName>String</d2p1:MiddleName>
<d2p1:ClientReference>String</d2p1:ClientReference>
<d2p1:MobileCountry>String</d2p1:MobileCountry>
<d2p1:MobileNumber>String</d2p1:MobileNumber>
<d2p1:ShareUsers>
<d2p1:ShareUser>
<d2p1:Email>String</d2p1:Email>
<d2p1:FirstName>String</d2p1:FirstName>
<d2p1:LastName>String</d2p1:LastName>
<d2p1:MiddleName>String</d2p1:MiddleName>
<d2p1:IsDefault>false</d2p1:IsDefault>
<d2p1:IsOwner>false</d2p1:IsOwner>
</d2p1:ShareUser>
</d2p1:ShareUsers>
<d2p1:IsFaceToFaceSigning>false</d2p1:IsFaceToFaceSigning>
<d2p1:ReviewBeforeSigningEnabled>false</d2p1:ReviewBeforeSigningEnabled>
<d2p1:SignerReference>String</d2p1:SignerReference>
<d2p1:VideoConfirmationEnabled>false</d2p1:VideoConfirmationEnabled>
</d2p1:Signer>
</d2p1:Signers>
</d2p1:FormFillerTemplate>
</Templates>
</SendFormFillerRequest>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <PackageResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SecuredSigning.Api.Rest.Models"> <Documents> <DocumentResponse> <Reference>String</Reference> <ClientReference>String</ClientReference> <DueDate>String</DueDate> <EditUrl>String</EditUrl> <Folder>String</Folder> <FormDirectReference>String</FormDirectReference> <GMT>String</GMT> <HasFileUploaded>false</HasFileUploaded> <IDVerificationRequested>false</IDVerificationRequested> <LastSignedDate>String</LastSignedDate> <Logs> <DocumentLog> <Action>String</Action> <Date>String</Date> <GMT>String</GMT> <Name>String</Name> <Role>String</Role> </DocumentLog> </Logs> <MatterNumber>String</MatterNumber> <Name>String</Name> <PackageReference>String</PackageReference> <Signers> <SignerStatusResponse> <Email>String</Email> <FirstName>String</FirstName> <LastName>String</LastName> <MiddleName>String</MiddleName> <ClientReference>String</ClientReference> <MobileCountry>String</MobileCountry> <MobileNumber>String</MobileNumber> <ShareUsers> <ShareUser> <Email>String</Email> <FirstName>String</FirstName> <LastName>String</LastName> <MiddleName>String</MiddleName> <IsDefault>false</IsDefault> <IsOwner>false</IsOwner> </ShareUser> </ShareUsers> <IsFaceToFaceSigning>false</IsFaceToFaceSigning> <ReviewBeforeSigningEnabled>false</ReviewBeforeSigningEnabled> <SignerReference>String</SignerReference> <VideoConfirmationEnabled>false</VideoConfirmationEnabled> <SigningKey>String</SigningKey> <DeclinedReason>String</DeclinedReason> <Editable>false</Editable> <HasSigned>false</HasSigned> <IDCheckStatus>String</IDCheckStatus> <IDVerificationFaceMatchResult>String</IDVerificationFaceMatchResult> <IDVerificationLivenessResult>String</IDVerificationLivenessResult> <IDVerificationResult>String</IDVerificationResult> <IDVerificationStatus>String</IDVerificationStatus> <SignedStatus>Initialized</SignedStatus> <VideoConfirmationDetail> <Email>String</Email> <IsVideoDisabled>false</IsVideoDisabled> <IsVideoOptOut>false</IsVideoOptOut> <IsVideoReady>false</IsVideoReady> <IsWitness>false</IsWitness> <Name>String</Name> <Password>String</Password> <ShortUrl>String</ShortUrl> <WitnessOwner>String</WitnessOwner> </VideoConfirmationDetail> </SignerStatusResponse> </Signers> <Status>String</Status> </DocumentResponse> </Documents> <PackageName>String</PackageName> <PackageReference>String</PackageReference> <PackageStatus>String</PackageStatus> <QueueReference>String</QueueReference> </PackageResponse>