RightSignature

Supported Formats

json

Errors

Code Description
400 invalid_scope
400 unauthorized_client
401 Can't find Reusable Template.
401 Unauthorized account for Reusable Template.
422 The role name supplied (<NAME>) does not match the role name expected.
422 Merge field ids do not match the reusable template's merge fields.

Params

Param name Description
name
optional

A name for the document you are sending

Validations:

  • Must be a String

shared_with
optional

List of email recipients to share the document with

Validations:

  • Must be an array of String

message
optional

A message for all signers

Validations:

  • Must be a String

redirect_url
optional

A URL to redirect to after sending the document. Must start with http:// or https://. Example: example.com/redirect

Validations:

  • Must be a String

callback_url
optional

Document callback url. The URL will receive a POST for each of the following document events: created, viewed, signed, executed. Note that due to the asynchronous nature of processing, the order in which the document callbacks are sent is not guaranteed. Only HTTP ports 80, 8000-8099, 3000-3009 and HTTPS port 443 is supported. Basic auth is also supported. Ex. “me:pass@yourhost.example:8001/callback”.

ex. callback when document is viewed

{
  "callbackType":"Document",
  "id":"edc7823a-7b99-45d7-9c3c-c7dc81f8dbf2",
  "event":"viewed",
  "documentState":"pending",
  "createdAt":"2016-11-14T13:45:23.199-08:00"
}

Validations:

  • Must be a String

merge_field_values
optional

Merge Fields

Validations:

  • Must be an Array of nested elements

merge_field_values[id]
required

Merge Field ID

Validations:

  • Must be a String

merge_field_values[value]
required

Merge Field value. If the merge field is a date, the value should be in yyyy/mm/dd or yyyy-mm-dd format.

Validations:

  • Must be a String

roles
required

Document signers

Validations:

  • Must be an Array of nested elements

roles[name]
required

Role name. For text tags, the role name in the request must correspond to the recipient name given as the second argument (name) in the text tag. When signer sequencing is enabled, the role name must match the signer name set on the template.

Validations:

  • Must be a String

roles[signer_name]
optional

Signer name

Validations:

  • Must be a String

roles[signer_email]
optional

Signer email

Validations:

  • Must be a String

roles[signer_omitted]
optional

A signer can be omitted if set to true and if signer_sequencing is enabled

Validations:

  • Must be one of: true, false.

roles[is_sender]
optional

Is signer the owner of document?

Validations:

  • Must be one of: true, false.

roles[message]
optional

Custom message to signer.

Validations:

  • Must be a String

expires_in
required

Document expiration. Must be between 1 and 365 days

pin
optional

Document pin. Must be between 10000 and 99999

tags
optional

Optional key value tags for categorization