Compartir por

SigningHub (Preview)

  • Reference

SigningHub is a complete solution for document approval workflows, advanced digital signatures and document status tracking. It is designed to quickly optimize the way businesses deliver, review, approve and sign their business documents

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Email support@ascertia.com
Connector Metadata
Publisher Ascertia
Website https://www.signinghub.com
Privacy policy https://www.signinghub.com/privacy-policy/

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

About SigningHub

Get the SigningHub instance details
Add recipient

Add a recipient into existing workflow
Apply template

Apply a provided template on the document workflow
Approve a document

Recipient can approve the workflow on this turn
Complete the workflow (Terminate in the middle)

Workflow owner can complete workflow at any stage to terminate it
Create a workflow

Create a new workflow inside the SigningHub
Decline a document

Recipient can decline the workflow on his turn
Delete a workflow

Delete existing workflow by the workflow owner
Delete recipient from a workflow

Delete a particular recipient from an existing workflow
Download a particular document from a workflow

Download a particular document from an existing workflow
Download all documents of a workflow

Download all the documents in extracted/zipped format of an existing workflow from SigningHub
Get contects

Get a list of contacts related to the logged-in user from SigningHub
Get recipients

Get a list of recipients of an existing workflow
Get templates

Get a list of all enterprise templates from SigningHub
Get workflow details

Get the workflow details
Get workflows

Get a list of workflows from SigningHub for the Logged-in user
Share a document workflow

Share a document workflow to the recipient
Sign document

Signs a document by logged-in-user
Upload a document into workflow

Upload a document into existing workflow

About SigningHub

Operation ID:
AboutSigningHub

Get the SigningHub instance details

Returns

Name Path Type Description
Build
 aboutSigningHub.build string

Build of SigningHub instance
Copyright
 aboutSigningHub.copyright string

Copyright of SigningHub
Installation name
 aboutSigningHub.installation_name string

Installation name of SigningHub instance
US Patent No.
 aboutSigningHub.patents.us_patent_no string

US Patent No. of SigningHub
Version
 aboutSigningHub.version string

Version of SigningHub instance

Add recipient

Operation ID:
AddRecipient

Add a recipient into existing workflow

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the existing workflow
Add signature field
 addSignatureField True boolean

Add a signature field into the workflow
Document ID
 documentId integer

The ID of the document
Email Notification
 emailNotification True boolean

Email notification
Only me
 onlyMe boolean

The type of recipient as only me
Page No.
 pageNo integer

The number of the document page
Page position
 pagePosition True string

the position on the page
Page X
 pageX integer

The horizontal position on the document page
Page Y
 pageY integer

The vertical position on the document page
Role
 role True string

The role of the recipient
Signing order
 signingOrder True integer

The order of the signing of the recipient
User email
 userEmail True string

The email of the recipient
User name
 userName True string

The name of the recipient

Returns

Name Path Type Description
Recipient added
 recipientAdded boolean

Recipient added response

Apply template

Operation ID:
ApplyTemplate

Apply a provided template on the document workflow

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow
Document ID
 documentId True integer

The ID of the document
Apply to all
 applyToAll True boolean

Apply to all documents
Template name
 templateName True string

The name of the applied template

Returns

Name Path Type Description
Certify enabled
 applyTemplate.certify.enabled boolean

The certify enabled value
Certify permission
 applyTemplate.certify.permission string

The certify permission value
Document height
 applyTemplate.document_height integer

The height of the document
Document ID
 applyTemplate.document_id integer

The ID of the document
Document name
 applyTemplate.document_name string

The name of the document
Document order
 applyTemplate.document_order integer

The order of the document in workflow
Document pages
 applyTemplate.document_pages integer

Total pages of the document
Document source
 applyTemplate.document_source string

The source of the document
Document type
 applyTemplate.document_type string

The type of the document
Document width
 applyTemplate.document_width integer

The width of the document
Form fields
 applyTemplate.form_fields boolean

The form fields availability in the document
Lock form fields
 applyTemplate.lock_form_fields boolean

The lock form fields enabled value
Modified on
 applyTemplate.modified_on string

The date of the modified
Read only
 applyTemplate.template.read_only boolean

The ready only type of the template
Template name
 applyTemplate.template.template_name string

The name of the applied template
Uploaded on
 applyTemplate.uploaded_on string

The date of the uploaded on

Approve a document

Operation ID:
ApproveDocument

Recipient can approve the workflow on this turn

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow
Approve reason
 approveReason string

The reason to approve the document

Returns

Name Path Type Description
Document approved
 documentApproved boolean

The status of the document approved

Complete the workflow (Terminate in the middle)

Operation ID:
CompleteWorkflow

Workflow owner can complete workflow at any stage to terminate it

Parameters

Name Key Required Type Description
Workflow ID
 packageId True string

The ID of the workflow

Returns

Name Path Type Description
Workflow completed
 workflowCompleted boolean

The status of the workflow completed

Create a workflow

Operation ID:
CreateWorkflow

Create a new workflow inside the SigningHub

Parameters

Name Key Required Type Description
Document content
 documentContent True string

The content of the document in base64
Workflow Name
 documentName True string

Create a new workflow inside the SigningHub

Returns

Name Path Type Description
Document ID
 documentId integer

The ID of the document
Package ID
 packageId integer

The ID of the workflow

Decline a document

Operation ID:
DeclineDocument

Recipient can decline the workflow on his turn

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow
Decline reason
 declineReason True string

The reason to decline the document

Returns

Name Path Type Description
Document declined
 documentDeclined boolean

The status of the document declined

Delete a workflow

Operation ID:
DeleteWorkflow

Delete existing workflow by the workflow owner

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow

Returns

Name Path Type Description
Workflow deleted
 packageDeleted boolean

The workflow deleted response

Delete recipient from a workflow

Operation ID:
DeleteRecipient

Delete a particular recipient from an existing workflow

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow
Order
 order True integer

The order of the deleted recipient

Returns

Name Path Type Description
Recipient deleted
 recipientDeleted boolean

The recipient deleted status

Download a particular document from a workflow

Operation ID:
DownloadDocument

Download a particular document from an existing workflow

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow
Document ID
 documentId True integer

The ID of the document

Returns

Name Path Type Description
Document content
 documentContent byte

The content of the document in base64 string
Document type
 documentType string

The type of the document

Download all documents of a workflow

Operation ID:
DownloadWorkflow

Download all the documents in extracted/zipped format of an existing workflow from SigningHub

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow

Returns

Name Path Type Description
Workflow content
 packageContent byte

The content of the workflow in base64 string
Workflow type
 packageType string

The type of the workflow content

Get contects

Operation ID:
GetContects

Get a list of contacts related to the logged-in user from SigningHub

Parameters

Name Key Required Type Description
Enterprise
 enterprise boolean

The enterprise contacts list
Page No.
 pageNo True integer

The number of the page
Records per page
 recordsPerPage True integer

The number of records per page
Search text
 searchText string

The searching text to filter out the list

Returns

Name Path Type Description
array of object
User email
 user_email string

The email of the user
User name
 user_name string

The name of the user
User national ID
 user_national_id string

The national ID of the user

Get recipients

Operation ID:
GetRecipients

Get a list of recipients of an existing workflow

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow

Returns

Name Path Type Description
recipients
 recipients array of object

recipients
Delegatee
 recipients.delegatee string

The email of the delegatee
Delegatee name
 recipients.delegatee_name string

The name of the delegatee
Group name
 recipients.group_name string

The name of the group
Order
 recipients.order integer

The order of the recipient
Placeholder
 recipients.placeholder string

The placeholder value
Process status
 recipients.process_status string

The status of the placeholder
Processed as
 recipients.processed_as string

The processed as value
Processed by
 recipients.processed_by string

The email of the processed by
Processed on
 recipients.processed_on string

The date of the processed
Reason
 recipients.reason string

The reason if any
Role
 recipients.role string

The role of the recipient
Signing order
 recipients.signing_order integer

The order of the signing
User email
 recipients.user_email string

The email of the user
User name
 recipients.user_name string

The name of the user
User national ID
 recipients.user_national_id string

The national ID of the user

Get templates

Operation ID:
GetTemplates

Get a list of all enterprise templates from SigningHub

Returns

Name Path Type Description
templatesCollection
 templatesCollection array of object

templatesCollection
templatesCollection.read_only boolean

read_only
template_id
 templatesCollection.template_id integer

template_id
template_name
 templatesCollection.template_name string

template_name
template_public
 templatesCollection.template_public boolean

template_public

Get workflow details

Operation ID:
GetWorkflowDetails

Get the workflow details

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow

Returns

Name Path Type Description
array of object
documents
 documents array of object

documents
allowed_permissions
 documents.certify.allowed_permissions array of string

allowed_permissions
default_permission
 documents.certify.default_permission string

default_permission
enabled
 documents.certify.enabled boolean

enabled
created_on
 documents.created_on string

created_on
document_height
 documents.document_height integer

document_height
document_id
 documents.document_id integer

document_id
document_name
 documents.document_name string

document_name
document_order
 documents.document_order integer

document_order
document_pages
 documents.document_pages integer

document_pages
document_source
 documents.document_source string

document_source
document_type
 documents.document_type string

document_type
document_width
 documents.document_width integer

document_width
form_fields
 documents.form_fields boolean

form_fields
lock_form_fields
 documents.lock_form_fields boolean

lock_form_fields
modified_on
 documents.modified_on string

modified_on
template
 documents.template string

template
Folder
 folder string

The folder type
Modified on
 modified_on string

The date of modified
Next signer
 next_signer string

The email of the next signer
next_signer_email
 next_signer_email array of

next_signer_email
Owner name
 owner_name string

The display name of owner
Workflow ID
 package_id integer

The ID of the workflow
Workflow name
 package_name string

The name of the workflow
Workflow owner
 package_owner string

The owner of the workflow
Package status
 package_status string

The current status of the workflow
Uploaded on
 uploaded_on string

The date of the workflow uploaded
users
 users array of

users
Continue on decline
 workflow.continue_on_decline boolean

Continue on decline of the workflow
contacts
 workflow.post_process.contacts array of

contacts
Dropbox
 workflow.post_process.dropbox boolean

The Dropbox enabled value
Google drive
 workflow.post_process.google_drive boolean

The Google drive enabled value
Workflow recipients
 workflow.post_process.workflow_recipients boolean

The workflow recipients value
Read only
 workflow.read_only boolean

The workflow read only value
Workflow mode
 workflow.workflow_mode string

The mode of the workflow
Workflow status
 workflow.workflow_status string

The status of the workflow
Workflow type
 workflow.workflow_type string

The type of the workflow

Get workflows

Operation ID:
GetWorkflows

Get a list of workflows from SigningHub for the Logged-in user

Parameters

Name Key Required Type Description
Document status
 documentStatus True string

The status of the document
Folder
 folder True string

The folder of the user's workflow
Page No.
 pageNo True integer

The number of the document page
Records per page
 recordsPerPage integer

The number of records per page
Search text
 searchText string

The search text to filter out the list

Returns

Name Path Type Description
array of object
Folder
 folder string

The folder of the user's workflow
Modified on
 modified_on string

The date of the modified
Next signer
 next_signer string

The next signer of the workflow
next_signer_email
 next_signer_email array of object

next_signer_email
user_email
 next_signer_email.user_email string

user_email
user_name
 next_signer_email.user_name string

user_name
Owner name
 owner_name string

The name of the workflow owner
Workflow ID
 package_id integer

The ID of the workflow
Workflow name
 package_name string

The name of the workflow
Workflow owner
 package_owner string

The email of the workflow owner
Workflow status
 package_status string

The status of the workflow
Unread
 unread boolean

Unread type
Uploaded on
 uploaded_on string

The date of the workflow uploaded

Share a document workflow

Operation ID:
ShareWorkflow

Share a document workflow to the recipient

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow

Returns

Name Path Type Description
array of object
Workflow ID
 packageID integer

The ID of shared workflow

Sign document

Operation ID:
SignDocument

Signs a document by logged-in-user

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the workflow
Document ID
 documentId True integer

The ID of the document
Page No.
 pageNo True integer

The number of the document page
Page position
 pagePosition True string

The position on the document page
Page X
 pageX integer

The horizontal position on document page
Page Y
 pageY integer

The vertical position on document page

Returns

Name Path Type Description
Document name
 documentName string

The name of signed document
Field name
 fieldName string

The name of signed field
Status
 status string

The status of the signed document

Upload a document into workflow

Operation ID:
UploadDocument

Upload a document into existing workflow

Parameters

Name Key Required Type Description
Workflow ID
 packageId True integer

The ID of the existing workflow
Document content
 documentContent True byte

The content of the added document in base64
Document name with extension
 documentName True string

The name of the added document with extension

Returns

Name Path Type Description
Document ID
 documentId string

The ID of the uploaded document