PYTHON SDK

Easily integrate BoldSign's e-signature features into your Python applications. This SDK simplifies sending documents for signature, embedding signing ceremonies, tracking document status, downloading signed documents, and managing e-signature workflows.

The Python SDK is available on PyPI and the source code can be found in the GitHub repository.

Install the BoldSign python SDK package by using the pip tool:

pip install boldsign 

By default, the latest stable version will be installed. If you want to switch to any specific version, you can do by mentioning the exact version in the command.

pip install boldsign==1.0.0b3

BoldSign python package can be found in this link-
https://pypi.org/project/boldsign/.

You can authenticate and configure the BoldSign Python SDK using either an API Key or a Bearer Token. Depending on your authentication method, you can set up with one of the two configurations outlined below.

To authenticate using an API Key, you'll need to first generate your API key. You can refer to the API-Key for more details .

Once you have your API key, you can configure as follows:

configuration = boldsign.Configuration(api_key="Your-API-Key-Here")
api_client = boldsign.ApiClient(configuration)

Replace "Your-API-Key-Here" with the actual API key you generated. After setting this up, the SDK will use this API key for authenticating all API requests.

To authenticate using an Bearer Token(Access Token), you'll need to first generate your Bearer Token. You can refer to the OAuth 2.0 for more details .

Once you have your Bearer Token, you can configure as follows:

configuration = boldsign.Configuration(access_token="Your-Bearer-Token-Here")
api_client = boldsign.ApiClient(configuration)

Replace "Your-Bearer-Token-Here" with the actual Bearer Token you generated. After setting this up, the SDK will use this Bearer Token for authenticating all API requests.

To prepare for sending a document for signing, you can authenticate using an API key or a Bearer token after importing the BoldSign SDK. This example demonstrates the authentication process using an API key.

import boldsign

configuration = boldsign.Configuration(
    api_key = "***your_api_key***"
)

with boldsign.ApiClient(configuration) as api_client:
   
   # Create an instance of the DocumentApi class
   document_api = boldsign.DocumentApi(api_client)

Now, define the signature field that will be added to your document. This involves specifying the field type (Signature), page number, and the bounds (position and size) of the field on the page.

# Define the signature field to be added to the document
signatureField = boldsign.FormField(
    fieldType="Signature",# Field type is Signature
    pageNumber=1,# Specify the page number
    bounds=boldsign.Rectangle(x=100, y=100, width=100, height=50), 
)

The document and its form fields require signing. So, specify the signer to sign the form fields, including their name and email address.

# Define the signer with a name and email address
signer = boldsign.DocumentSigner(
    name="David", 
    emailAddress="david@example.com", 
    signerType="Signer", 
    formFields=[signatureField]
)

Now, prepare the document you want to send for signature. Specify the title of the document, the signers involved, and the file(s) to be signed. In this case, we are sending a PDF document.

# Prepare the request body for sending the document for signature
send_for_sign = boldsign.SendForSign(
    title="Agreement", 
    signers=[signer],
    files=["/documents/agreement.pdf"] 
)

The last step is to send the document for signing with the defined document, form fields and signer.

# Send the document for signature and capture the response
api_response = document_api.send_document(send_for_sign=send_for_sign)

The return type api_response will contain the document ID of the document created, which can be used in later stages to get the particular document related operations.

You can find the Python example application in the official GitHub repository. Additional code examples are available in this GitHub repository.

Refer to the Python SDK class reference documentation here.