A list of all methods in the SignplusService service. Click on the method name to view detailed information about that method.

MethodsDescription
create_envelopeCreate new envelope
create_envelope_from_templateCreate new envelope from template
list_envelopesList envelopes
get_envelopeGet envelope
delete_envelopeDelete envelope
get_envelope_documentGet envelope document
get_envelope_documentsGet envelope documents
add_envelope_documentAdd envelope document
set_envelope_dynamic_fieldsSet envelope dynamic fields
add_envelope_signing_stepsAdd envelope signing steps
send_envelopeSend envelope for signature
duplicate_envelopeDuplicate envelope
void_envelopeVoid envelope
rename_envelopeRename envelope
set_envelope_commentSet envelope comment
set_envelope_notificationSet envelope notification
set_envelope_expiration_dateSet envelope expiration date
set_envelope_legality_levelSet envelope legality level
get_envelope_annotationsGet envelope annotations
get_envelope_document_annotationsGet envelope document annotations
add_envelope_annotationAdd envelope annotation
delete_envelope_annotationDelete envelope annotation
create_templateCreate new template
list_templatesList templates
get_templateGet template
delete_templateDelete template
duplicate_templateDuplicate template
add_template_documentAdd template document
get_template_documentGet template document
get_template_documentsGet template documents
add_template_signing_stepsAdd template signing steps
rename_templateRename template
set_template_commentSet template comment
set_template_notificationSet template notification
get_template_annotationsGet template annotations
get_document_template_annotationsGet document template annotations
add_template_annotationAdd template annotation
delete_template_annotationDelete template annotation
create_webhookCreate webhook
list_webhooksList webhooks
delete_webhookDelete webhook

create_envelope

Create new envelope

  • HTTP Method: POST
  • Endpoint: /envelope

Parameters

NameTypeRequiredDescription
request_bodyCreateEnvelopeRequestThe request body.

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import CreateEnvelopeRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = CreateEnvelopeRequest(
    name="name",
    legality_level="SES",
    expires_at=10,
    comment="comment",
    sandbox=True
)

result = sdk.signplus.create_envelope(request_body=request_body)

print(result)

create_envelope_from_template

Create new envelope from template

  • HTTP Method: POST
  • Endpoint: /envelope/from_template/{template_id}

Parameters

NameTypeRequiredDescription
request_bodyCreateEnvelopeFromTemplateRequestThe request body.
template_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import CreateEnvelopeFromTemplateRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = CreateEnvelopeFromTemplateRequest(
    name="name",
    comment="comment",
    sandbox=False
)

result = sdk.signplus.create_envelope_from_template(
    request_body=request_body,
    template_id="template_id"
)

print(result)

list_envelopes

List envelopes

  • HTTP Method: POST
  • Endpoint: /envelopes

Parameters

NameTypeRequiredDescription
request_bodyListEnvelopesRequestThe request body.

Return Type

ListEnvelopesResponse

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import ListEnvelopesRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = ListEnvelopesRequest(
    name="name",
    tags=[
        "tags"
    ],
    comment="comment",
    ids=[
        "ids"
    ],
    statuses=[
        "DRAFT"
    ],
    folder_ids=[
        "folder_ids"
    ],
    only_root_folder=True,
    date_from=1,
    date_to=3,
    uid="uid",
    first=6,
    last=8,
    after="after",
    before="before",
    order_field="CREATION_DATE",
    ascending=True,
    include_trash=True
)

result = sdk.signplus.list_envelopes(request_body=request_body)

print(result)

get_envelope

Get envelope

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_envelope(envelope_id="envelope_id")

print(result)

delete_envelope

Delete envelope

  • HTTP Method: DELETE
  • Endpoint: /envelope/{envelope_id}

Parameters

NameTypeRequiredDescription
envelope_idstr

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.delete_envelope(envelope_id="envelope_id")

print(result)

get_envelope_document

Get envelope document

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/document/{document_id}

Parameters

NameTypeRequiredDescription
envelope_idstr
document_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_envelope_document(
    envelope_id="envelope_id",
    document_id="document_id"
)

print(result)

get_envelope_documents

Get envelope documents

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/documents

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

ListEnvelopeDocumentsResponse

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_envelope_documents(envelope_id="envelope_id")

print(result)

add_envelope_document

Add envelope document

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/document

Parameters

NameTypeRequiredDescription
request_bodyAddEnvelopeDocumentRequestThe request body.
envelope_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import AddEnvelopeDocumentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = AddEnvelopeDocumentRequest(
    file="file"
)

result = sdk.signplus.add_envelope_document(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_dynamic_fields

Set envelope dynamic fields

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/dynamic_fields

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeDynamicFieldsRequestThe request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import SetEnvelopeDynamicFieldsRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = SetEnvelopeDynamicFieldsRequest(
    dynamic_fields=[
        {
            "name": "name",
            "value": "value"
        }
    ]
)

result = sdk.signplus.set_envelope_dynamic_fields(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

add_envelope_signing_steps

Add envelope signing steps

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/signing_steps

Parameters

NameTypeRequiredDescription
request_bodyAddEnvelopeSigningStepsRequestThe request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import AddEnvelopeSigningStepsRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = AddEnvelopeSigningStepsRequest(
    signing_steps=[
        {
            "recipients": [
                {
                    "id_": "id",
                    "uid": "uid",
                    "name": "name",
                    "email": "email",
                    "role": "SIGNER",
                    "verification": {
                        "type_": "SMS",
                        "value": "value"
                    }
                }
            ]
        }
    ]
)

result = sdk.signplus.add_envelope_signing_steps(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

send_envelope

Send envelope for signature

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/send

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.send_envelope(envelope_id="envelope_id")

print(result)

duplicate_envelope

Duplicate envelope

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/duplicate

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.duplicate_envelope(envelope_id="envelope_id")

print(result)

void_envelope

Void envelope

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/void

Parameters

NameTypeRequiredDescription
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.void_envelope(envelope_id="envelope_id")

print(result)

rename_envelope

Rename envelope

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/rename

Parameters

NameTypeRequiredDescription
request_bodyRenameEnvelopeRequestThe request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import RenameEnvelopeRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = RenameEnvelopeRequest(
    name="name"
)

result = sdk.signplus.rename_envelope(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_comment

Set envelope comment

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_comment

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeCommentRequestThe request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import SetEnvelopeCommentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = SetEnvelopeCommentRequest(
    comment="comment"
)

result = sdk.signplus.set_envelope_comment(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_notification

Set envelope notification

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_notification

Parameters

NameTypeRequiredDescription
request_bodyEnvelopeNotificationThe request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import EnvelopeNotification

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = EnvelopeNotification(
    subject="subject",
    message="message",
    reminder_interval=9
)

result = sdk.signplus.set_envelope_notification(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_expiration_date

Set envelope expiration date

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_expiration_date

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeExpirationRequestThe request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import SetEnvelopeExpirationRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = SetEnvelopeExpirationRequest(
    expires_at=6
)

result = sdk.signplus.set_envelope_expiration_date(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

set_envelope_legality_level

Set envelope legality level

  • HTTP Method: PUT
  • Endpoint: /envelope/{envelope_id}/set_legality_level

Parameters

NameTypeRequiredDescription
request_bodySetEnvelopeLegalityLevelRequestThe request body.
envelope_idstr

Return Type

Envelope

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import SetEnvelopeLegalityLevelRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = SetEnvelopeLegalityLevelRequest(
    legality_level="SES"
)

result = sdk.signplus.set_envelope_legality_level(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

get_envelope_annotations

Get envelope annotations

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/annotations

Parameters

NameTypeRequiredDescription
envelope_idstrID of the envelope

Return Type

List[Annotation]

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_envelope_annotations(envelope_id="envelope_id")

print(result)

get_envelope_document_annotations

Get envelope document annotations

  • HTTP Method: GET
  • Endpoint: /envelope/{envelope_id}/annotations/{document_id}

Parameters

NameTypeRequiredDescription
envelope_idstrID of the envelope
document_idstrID of document

Return Type

ListEnvelopeDocumentAnnotationsResponse

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_envelope_document_annotations(
    envelope_id="envelope_id",
    document_id="document_id"
)

print(result)

add_envelope_annotation

Add envelope annotation

  • HTTP Method: POST
  • Endpoint: /envelope/{envelope_id}/annotation

Parameters

NameTypeRequiredDescription
request_bodyAddAnnotationRequestThe request body.
envelope_idstrID of the envelope

Return Type

Annotation

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import AddAnnotationRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = AddAnnotationRequest(
    recipient_id="recipient_id",
    document_id="document_id",
    page=3,
    x=1.92,
    y=1.94,
    width=4.18,
    height=0.39,
    required=True,
    type_="TEXT",
    signature={
        "id_": "id"
    },
    initials={
        "id_": "id"
    },
    text={
        "size": 3.33,
        "color": 9.42,
        "value": "value",
        "tooltip": "tooltip",
        "dynamic_field_name": "dynamic_field_name",
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": True
        }
    },
    datetime_={
        "size": 8.42,
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": True
        },
        "color": "color",
        "auto_fill": False,
        "timezone": "timezone",
        "timestamp": 7,
        "format": "DMY_NUMERIC_SLASH"
    },
    checkbox={
        "checked": True,
        "style": "CIRCLE_CHECK"
    }
)

result = sdk.signplus.add_envelope_annotation(
    request_body=request_body,
    envelope_id="envelope_id"
)

print(result)

delete_envelope_annotation

Delete envelope annotation

  • HTTP Method: DELETE
  • Endpoint: /envelope/{envelope_id}/annotation/{annotation_id}

Parameters

NameTypeRequiredDescription
envelope_idstrID of the envelope
annotation_idstrID of the annotation to delete

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.delete_envelope_annotation(
    envelope_id="envelope_id",
    annotation_id="annotation_id"
)

print(result)

create_template

Create new template

  • HTTP Method: POST
  • Endpoint: /template

Parameters

NameTypeRequiredDescription
request_bodyCreateTemplateRequestThe request body.

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import CreateTemplateRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = CreateTemplateRequest(
    name="name"
)

result = sdk.signplus.create_template(request_body=request_body)

print(result)

list_templates

List templates

  • HTTP Method: POST
  • Endpoint: /templates

Parameters

NameTypeRequiredDescription
request_bodyListTemplatesRequestThe request body.

Return Type

ListTemplatesResponse

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import ListTemplatesRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = ListTemplatesRequest(
    name="name",
    tags=[
        "tags"
    ],
    ids=[
        "ids"
    ],
    first=3,
    last=1,
    after="after",
    before="before",
    order_field="TEMPLATE_ID",
    ascending=True
)

result = sdk.signplus.list_templates(request_body=request_body)

print(result)

get_template

Get template

  • HTTP Method: GET
  • Endpoint: /template/{template_id}

Parameters

NameTypeRequiredDescription
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_template(template_id="template_id")

print(result)

delete_template

Delete template

  • HTTP Method: DELETE
  • Endpoint: /template/{template_id}

Parameters

NameTypeRequiredDescription
template_idstr

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.delete_template(template_id="template_id")

print(result)

duplicate_template

Duplicate template

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/duplicate

Parameters

NameTypeRequiredDescription
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.duplicate_template(template_id="template_id")

print(result)

add_template_document

Add template document

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/document

Parameters

NameTypeRequiredDescription
request_bodyAddTemplateDocumentRequestThe request body.
template_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import AddTemplateDocumentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = AddTemplateDocumentRequest(
    file="file"
)

result = sdk.signplus.add_template_document(
    request_body=request_body,
    template_id="template_id"
)

print(result)

get_template_document

Get template document

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/document/{document_id}

Parameters

NameTypeRequiredDescription
template_idstr
document_idstr

Return Type

Document

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_template_document(
    template_id="template_id",
    document_id="document_id"
)

print(result)

get_template_documents

Get template documents

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/documents

Parameters

NameTypeRequiredDescription
template_idstr

Return Type

ListTemplateDocumentsResponse

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_template_documents(template_id="template_id")

print(result)

add_template_signing_steps

Add template signing steps

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/signing_steps

Parameters

NameTypeRequiredDescription
request_bodyAddTemplateSigningStepsRequestThe request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import AddTemplateSigningStepsRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = AddTemplateSigningStepsRequest(
    signing_steps=[
        {
            "recipients": [
                {
                    "id_": "id",
                    "uid": "uid",
                    "name": "name",
                    "email": "email",
                    "role": "SIGNER"
                }
            ]
        }
    ]
)

result = sdk.signplus.add_template_signing_steps(
    request_body=request_body,
    template_id="template_id"
)

print(result)

rename_template

Rename template

  • HTTP Method: PUT
  • Endpoint: /template/{template_id}/rename

Parameters

NameTypeRequiredDescription
request_bodyRenameTemplateRequestThe request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import RenameTemplateRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = RenameTemplateRequest(
    name="name"
)

result = sdk.signplus.rename_template(
    request_body=request_body,
    template_id="template_id"
)

print(result)

set_template_comment

Set template comment

  • HTTP Method: PUT
  • Endpoint: /template/{template_id}/set_comment

Parameters

NameTypeRequiredDescription
request_bodySetTemplateCommentRequestThe request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import SetTemplateCommentRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = SetTemplateCommentRequest(
    comment="comment"
)

result = sdk.signplus.set_template_comment(
    request_body=request_body,
    template_id="template_id"
)

print(result)

set_template_notification

Set template notification

  • HTTP Method: PUT
  • Endpoint: /template/{template_id}/set_notification

Parameters

NameTypeRequiredDescription
request_bodyEnvelopeNotificationThe request body.
template_idstr

Return Type

Template

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import EnvelopeNotification

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = EnvelopeNotification(
    subject="subject",
    message="message",
    reminder_interval=9
)

result = sdk.signplus.set_template_notification(
    request_body=request_body,
    template_id="template_id"
)

print(result)

get_template_annotations

Get template annotations

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/annotations

Parameters

NameTypeRequiredDescription
template_idstrID of the template

Return Type

ListTemplateAnnotationsResponse

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_template_annotations(template_id="template_id")

print(result)

get_document_template_annotations

Get document template annotations

  • HTTP Method: GET
  • Endpoint: /template/{template_id}/annotations/{document_id}

Parameters

NameTypeRequiredDescription
template_idstrID of the template
document_idstrID of document

Return Type

ListTemplateDocumentAnnotationsResponse

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.get_document_template_annotations(
    template_id="template_id",
    document_id="document_id"
)

print(result)

add_template_annotation

Add template annotation

  • HTTP Method: POST
  • Endpoint: /template/{template_id}/annotation

Parameters

NameTypeRequiredDescription
request_bodyAddAnnotationRequestThe request body.
template_idstrID of the template

Return Type

Annotation

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import AddAnnotationRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = AddAnnotationRequest(
    recipient_id="recipient_id",
    document_id="document_id",
    page=3,
    x=1.92,
    y=1.94,
    width=4.18,
    height=0.39,
    required=True,
    type_="TEXT",
    signature={
        "id_": "id"
    },
    initials={
        "id_": "id"
    },
    text={
        "size": 3.33,
        "color": 9.42,
        "value": "value",
        "tooltip": "tooltip",
        "dynamic_field_name": "dynamic_field_name",
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": True
        }
    },
    datetime_={
        "size": 8.42,
        "font": {
            "family": "UNKNOWN",
            "italic": True,
            "bold": True
        },
        "color": "color",
        "auto_fill": False,
        "timezone": "timezone",
        "timestamp": 7,
        "format": "DMY_NUMERIC_SLASH"
    },
    checkbox={
        "checked": True,
        "style": "CIRCLE_CHECK"
    }
)

result = sdk.signplus.add_template_annotation(
    request_body=request_body,
    template_id="template_id"
)

print(result)

delete_template_annotation

Delete template annotation

  • HTTP Method: DELETE
  • Endpoint: /template/{template_id}/annotation/{annotation_id}

Parameters

NameTypeRequiredDescription
template_idstrID of the template
annotation_idstrID of the annotation to delete

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.delete_template_annotation(
    template_id="template_id",
    annotation_id="annotation_id"
)

print(result)

create_webhook

Create webhook

  • HTTP Method: POST
  • Endpoint: /webhook

Parameters

NameTypeRequiredDescription
request_bodyCreateWebhookRequestThe request body.

Return Type

Webhook

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import CreateWebhookRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = CreateWebhookRequest(
    event="ENVELOPE_EXPIRED",
    target="target"
)

result = sdk.signplus.create_webhook(request_body=request_body)

print(result)

list_webhooks

List webhooks

  • HTTP Method: POST
  • Endpoint: /webhooks

Parameters

NameTypeRequiredDescription
request_bodyListWebhooksRequestThe request body.

Return Type

ListWebhooksResponse

Example Usage Code Snippet

from signplus import Signplus
from signplus.models import ListWebhooksRequest

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

request_body = ListWebhooksRequest(
    webhook_id="webhook_id",
    event="ENVELOPE_EXPIRED"
)

result = sdk.signplus.list_webhooks(request_body=request_body)

print(result)

delete_webhook

Delete webhook

  • HTTP Method: DELETE
  • Endpoint: /webhook/{webhook_id}

Parameters

NameTypeRequiredDescription
webhook_idstr

Example Usage Code Snippet

from signplus import Signplus

sdk = Signplus(
    access_token="YOUR_ACCESS_TOKEN",
    timeout=10000
)

result = sdk.signplus.delete_webhook(webhook_id="webhook_id")

print(result)

Models

Document

Properties

NameTypeRequiredDescription
id_strUnique identifier of the document
namestrName of the document
filenamestrFilename of the document
page_countintNumber of pages in the document
pagesList[Page]List of pages in the document

CreateEnvelopeRequest

Properties

NameTypeRequiredDescription
namestrName of the envelope
legality_levelEnvelopeLegalityLevelLegal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)
expires_atintUnix timestamp of the expiration date
commentstrComment for the envelope
sandboxboolWhether the envelope is created in sandbox mode

ListEnvelopesRequest

Properties

NameTypeRequiredDescription
namestrName of the envelope
tagsList[str]List of tags
commentstrComment of the envelope
idsList[str]List of envelope IDs
statusesList[EnvelopeStatus]List of envelope statuses
folder_idsList[str]List of folder IDs
only_root_folderboolWhether to only list envelopes in the root folder
date_fromintUnix timestamp of the start date
date_tointUnix timestamp of the end date
uidstrUnique identifier of the user
firstint
lastint
afterstr
beforestr
order_fieldEnvelopeOrderFieldField to order envelopes by
ascendingboolWhether to order envelopes in ascending order
include_trashboolWhether to include envelopes in the trash

EnvelopeNotification

Properties

NameTypeRequiredDescription
subjectstrSubject of the notification
messagestrMessage of the notification
reminder_intervalintInterval in days to send reminder

ListTemplatesRequest

Properties

NameTypeRequiredDescription
namestrName of the template
tagsList[str]List of tag templates
idsList[str]List of templates IDs
firstint
lastint
afterstr
beforestr
order_fieldTemplateOrderFieldField to order templates by
ascendingboolWhether to order templates in ascending order

SetTemplateCommentRequest

Properties

NameTypeRequiredDescription
commentstrComment for the template

Template

Properties

NameTypeRequiredDescription
id_strUnique identifier of the template
namestrName of the template
commentstrComment for the template
pagesintTotal number of pages in the template
legality_levelEnvelopeLegalityLevelLegal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)
created_atintUnix timestamp of the creation date
updated_atintUnix timestamp of the last modification date
expiration_delayintExpiration delay added to the current time when an envelope is created from this template
num_recipientsintNumber of recipients in the envelope
signing_stepsList[TemplateSigningStep]
documentsList[Document]
notificationEnvelopeNotification
dynamic_fieldsList[str]List of dynamic fields

RecipientVerificationType

Type of signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered)

Properties

NameTypeRequiredDescription
SMSstr“SMS”
PASSCODEstr“PASSCODE”

AddEnvelopeSigningStepsRequest

Properties

NameTypeRequiredDescription
signing_stepsList[SigningStep]List of signing steps

AnnotationFontFamily

Font family of the text

Properties

NameTypeRequiredDescription
UNKNOWNstr“UNKNOWN”
SERIFstr“SERIF”
SANSstr“SANS”
MONOstr“MONO”

AddTemplateSigningStepsRequest

Properties

NameTypeRequiredDescription
signing_stepsList[TemplateSigningStep]List of signing steps

SetEnvelopeCommentRequest

Properties

NameTypeRequiredDescription
commentstrComment for the envelope

TemplateOrderField

Field to order templates by

Properties

NameTypeRequiredDescription
TEMPLATEIDstr“TEMPLATE_ID”
TEMPLATECREATIONDATEstr“TEMPLATE_CREATION_DATE”
TEMPLATEMODIFICATIONDATEstr“TEMPLATE_MODIFICATION_DATE”
TEMPLATENAMEstr“TEMPLATE_NAME”

EnvelopeOrderField

Field to order envelopes by

Properties

NameTypeRequiredDescription
CREATIONDATEstr“CREATION_DATE”
MODIFICATIONDATEstr“MODIFICATION_DATE”
NAMEstr“NAME”
STATUSstr“STATUS”
LASTDOCUMENTCHANGEstr“LAST_DOCUMENT_CHANGE”

AddEnvelopeDocumentRequest

Properties

NameTypeRequiredDescription
filebytesFile to upload in binary format

ListWebhooksRequest

Properties

NameTypeRequiredDescription
webhook_idstrID of the webhook
eventWebhookEventEvent of the webhook

SetEnvelopeLegalityLevelRequest

Properties

NameTypeRequiredDescription
legality_levelEnvelopeLegalityLevelLegal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)

SetEnvelopeExpirationRequest

Properties

NameTypeRequiredDescription
expires_atintUnix timestamp of the expiration date

AnnotationText

Text annotation (null if annotation is not a text)

Properties

NameTypeRequiredDescription
sizefloatFont size of the text in pt
colorfloatText color in 32bit representation
valuestrText content of the annotation
tooltipstrTooltip of the annotation
dynamic_field_namestrName of the dynamic field
fontAnnotationFont

AnnotationCheckbox

Checkbox annotation (null if annotation is not a checkbox)

Properties

NameTypeRequiredDescription
checkedboolWhether the checkbox is checked
styleAnnotationCheckboxStyleStyle of the checkbox

Envelope

Properties

NameTypeRequiredDescription
id_strUnique identifier of the envelope
namestrName of the envelope
commentstrComment for the envelope
pagesintTotal number of pages in the envelope
flow_typeEnvelopeFlowTypeFlow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow)
legality_levelEnvelopeLegalityLevelLegal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)
statusEnvelopeStatusStatus of the envelope
created_atintUnix timestamp of the creation date
updated_atintUnix timestamp of the last modification date
expires_atintUnix timestamp of the expiration date
num_recipientsintNumber of recipients in the envelope
is_duplicableboolWhether the envelope can be duplicated
signing_stepsList[SigningStep]
documentsList[Document]
notificationEnvelopeNotification

AddTemplateDocumentRequest

Properties

NameTypeRequiredDescription
filebytesFile to upload in binary format

TemplateRecipient

Properties

NameTypeRequiredDescription
id_strUnique identifier of the recipient
uidstrUnique identifier of the user associated with the recipient
namestrName of the recipient
emailstrEmail of the recipient
roleTemplateRecipientRoleRole of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document)

AddAnnotationRequest

Properties

NameTypeRequiredDescription
document_idstrID of the document
pageintPage number where the annotation is placed
xfloatX coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner
yfloatY coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner
widthfloatWidth of the annotation (in % of the page width from 0 to 100)
heightfloatHeight of the annotation (in % of the page height from 0 to 100)
type_AnnotationTypeType of the annotation
recipient_idstrID of the recipient
requiredbool
signatureAnnotationSignatureSignature annotation (null if annotation is not a signature)
initialsAnnotationInitialsInitials annotation (null if annotation is not initials)
textAnnotationTextText annotation (null if annotation is not a text)
datetime_AnnotationDateTimeDate annotation (null if annotation is not a date)
checkboxAnnotationCheckboxCheckbox annotation (null if annotation is not a checkbox)

ListEnvelopeDocumentAnnotationsResponse

Properties

NameTypeRequiredDescription
annotationsList[Annotation]

EnvelopeStatus

Status of the envelope

Properties

NameTypeRequiredDescription
DRAFTstr“DRAFT”
INPROGRESSstr“IN_PROGRESS”
COMPLETEDstr“COMPLETED”
EXPIREDstr“EXPIRED”
DECLINEDstr“DECLINED”
VOIDEDstr“VOIDED”
PENDINGstr“PENDING”

RecipientVerification

Properties

NameTypeRequiredDescription
type_RecipientVerificationTypeType of signature verification (SMS sends a code via SMS, PASSCODE requires a code to be entered)
valuestr

AnnotationCheckboxStyle

Style of the checkbox

Properties

NameTypeRequiredDescription
CIRCLECHECKstr“CIRCLE_CHECK”
CIRCLEFULLstr“CIRCLE_FULL”
SQUARECHECKstr“SQUARE_CHECK”
SQUAREFULLstr“SQUARE_FULL”
CHECKMARKstr“CHECK_MARK”
TIMESSQUAREstr“TIMES_SQUARE”

SigningStep

Properties

NameTypeRequiredDescription
recipientsList[Recipient]List of recipients

AnnotationDateTime

Date annotation (null if annotation is not a date)

Properties

NameTypeRequiredDescription
sizefloatFont size of the text in pt
fontAnnotationFont
colorstrColor of the text in hex format
auto_fillboolWhether the date should be automatically filled
timezonestrTimezone of the date
timestampintUnix timestamp of the date
formatAnnotationDateTimeFormatFormat of the date time (DMY_NUMERIC_SLASH is day/month/year with slashes, MDY_NUMERIC_SLASH is month/day/year with slashes, YMD_NUMERIC_SLASH is year/month/day with slashes, DMY_NUMERIC_DASH_SHORT is day/month/year with dashes, DMY_NUMERIC_DASH is day/month/year with dashes, YMD_NUMERIC_DASH is year/month/day with dashes, MDY_TEXT_DASH_SHORT is month/day/year with dashes, MDY_TEXT_SPACE_SHORT is month/day/year with spaces, MDY_TEXT_SPACE is month/day/year with spaces)

CreateTemplateRequest

Properties

NameTypeRequiredDescription
namestr

ListTemplateDocumentsResponse

Properties

NameTypeRequiredDescription
documentsList[Document]

AnnotationInitials

Initials annotation (null if annotation is not initials)

Properties

NameTypeRequiredDescription
id_strUnique identifier of the annotation initials

AnnotationFont

Properties

NameTypeRequiredDescription
familyAnnotationFontFamilyFont family of the text
italicboolWhether the text is italic
boldboolWhether the text is bold

AnnotationType

Type of the annotation

Properties

NameTypeRequiredDescription
TEXTstr“TEXT”
SIGNATUREstr“SIGNATURE”
INITIALSstr“INITIALS”
CHECKBOXstr“CHECKBOX”
DATEstr“DATE”

Webhook

Properties

NameTypeRequiredDescription
id_strUnique identifier of the webhook
eventWebhookEventEvent of the webhook
targetstrTarget URL of the webhook

RenameTemplateRequest

Properties

NameTypeRequiredDescription
namestrName of the template

ListTemplatesResponse

Properties

NameTypeRequiredDescription
has_next_pageboolWhether there is a next page
has_previous_pageboolWhether there is a previous page
templatesList[Template]

RecipientRole

Role of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document)

Properties

NameTypeRequiredDescription
SIGNERstr“SIGNER”
RECEIVESCOPYstr“RECEIVES_COPY”
INPERSONSIGNERstr“IN_PERSON_SIGNER”

Annotation

Properties

NameTypeRequiredDescription
id_strUnique identifier of the annotation
recipient_idstrID of the recipient
document_idstrID of the document
pageintPage number where the annotation is placed
xfloatX coordinate of the annotation (in % of the page width from 0 to 100) from the top left corner
yfloatY coordinate of the annotation (in % of the page height from 0 to 100) from the top left corner
widthfloatWidth of the annotation (in % of the page width from 0 to 100)
heightfloatHeight of the annotation (in % of the page height from 0 to 100)
requiredboolWhether the annotation is required
type_AnnotationTypeType of the annotation
signatureAnnotationSignatureSignature annotation (null if annotation is not a signature)
initialsAnnotationInitialsInitials annotation (null if annotation is not initials)
textAnnotationTextText annotation (null if annotation is not a text)
datetime_AnnotationDateTimeDate annotation (null if annotation is not a date)
checkboxAnnotationCheckboxCheckbox annotation (null if annotation is not a checkbox)

DynamicField

Properties

NameTypeRequiredDescription
namestrName of the dynamic field
valuestrValue of the dynamic field

AnnotationDateTimeFormat

Format of the date time (DMY_NUMERIC_SLASH is day/month/year with slashes, MDY_NUMERIC_SLASH is month/day/year with slashes, YMD_NUMERIC_SLASH is year/month/day with slashes, DMY_NUMERIC_DASH_SHORT is day/month/year with dashes, DMY_NUMERIC_DASH is day/month/year with dashes, YMD_NUMERIC_DASH is year/month/day with dashes, MDY_TEXT_DASH_SHORT is month/day/year with dashes, MDY_TEXT_SPACE_SHORT is month/day/year with spaces, MDY_TEXT_SPACE is month/day/year with spaces)

Properties

NameTypeRequiredDescription
DMYNUMERICSLASHstr“DMY_NUMERIC_SLASH”
MDYNUMERICSLASHstr“MDY_NUMERIC_SLASH”
YMDNUMERICSLASHstr“YMD_NUMERIC_SLASH”
DMYNUMERICDASHSHORTstr“DMY_NUMERIC_DASH_SHORT”
DMYNUMERICDASHstr“DMY_NUMERIC_DASH”
YMDNUMERICDASHstr“YMD_NUMERIC_DASH”
MDYTEXTDASHSHORTstr“MDY_TEXT_DASH_SHORT”
MDYTEXTSPACESHORTstr“MDY_TEXT_SPACE_SHORT”
MDYTEXTSPACEstr“MDY_TEXT_SPACE”

EnvelopeFlowType

Flow type of the envelope (REQUEST_SIGNATURE is a request for signature, SIGN_MYSELF is a self-signing flow)

Properties

NameTypeRequiredDescription
REQUESTSIGNATUREstr“REQUEST_SIGNATURE”
SIGNMYSELFstr“SIGN_MYSELF”

EnvelopeLegalityLevel

Legal level of the envelope (SES is Simple Electronic Signature, QES_EIDAS is Qualified Electronic Signature, QES_ZERTES is Qualified Electronic Signature with Zertes)

Properties

NameTypeRequiredDescription
SESstr“SES”
QESEIDASstr“QES_EIDAS”
QESZERTESstr“QES_ZERTES”

TemplateRecipientRole

Role of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document)

Properties

NameTypeRequiredDescription
SIGNERstr“SIGNER”
RECEIVESCOPYstr“RECEIVES_COPY”
INPERSONSIGNERstr“IN_PERSON_SIGNER”

SetEnvelopeDynamicFieldsRequest

Properties

NameTypeRequiredDescription
dynamic_fieldsList[DynamicField]List of dynamic fields

Page

Properties

NameTypeRequiredDescription
widthintWidth of the page in pixels
heightintHeight of the page in pixels

TemplateSigningStep

Properties

NameTypeRequiredDescription
recipientsList[TemplateRecipient]List of recipients

ListEnvelopesResponse

Properties

NameTypeRequiredDescription
has_next_pageboolWhether there is a next page
has_previous_pageboolWhether there is a previous page
envelopesList[Envelope]

Recipient

Properties

NameTypeRequiredDescription
namestrName of the recipient
emailstrEmail of the recipient
roleRecipientRoleRole of the recipient (SIGNER signs the document, RECEIVES_COPY receives a copy of the document, IN_PERSON_SIGNER signs the document in person, SENDER sends the document)
id_strUnique identifier of the recipient
uidstrUnique identifier of the user associated with the recipient
verificationRecipientVerification

WebhookEvent

Event of the webhook

Properties

NameTypeRequiredDescription
ENVELOPEEXPIREDstr“ENVELOPE_EXPIRED”
ENVELOPEDECLINEDstr“ENVELOPE_DECLINED”
ENVELOPEVOIDEDstr“ENVELOPE_VOIDED”
ENVELOPECOMPLETEDstr“ENVELOPE_COMPLETED”
ENVELOPEAUDITTRAILstr“ENVELOPE_AUDIT_TRAIL”

CreateWebhookRequest

Properties

NameTypeRequiredDescription
eventWebhookEventEvent of the webhook
targetstrURL of the webhook target

CreateEnvelopeFromTemplateRequest

Properties

NameTypeRequiredDescription
namestrName of the envelope
commentstrComment for the envelope
sandboxboolWhether the envelope is created in sandbox mode

ListTemplateAnnotationsResponse

Properties

NameTypeRequiredDescription
annotationsList[Annotation]

RenameEnvelopeRequest

Properties

NameTypeRequiredDescription
namestrName of the envelope

ListTemplateDocumentAnnotationsResponse

Properties

NameTypeRequiredDescription
annotationsList[Annotation]

ListEnvelopeDocumentsResponse

Properties

NameTypeRequiredDescription
documentsList[Document]

ListWebhooksResponse

Properties

NameTypeRequiredDescription
webhooksList[Webhook]

AnnotationSignature

Signature annotation (null if annotation is not a signature)

Properties

NameTypeRequiredDescription
id_strUnique identifier of the annotation signature