Skip to content
  1. Blog
  2. General

Introducing the BoldSign Python SDK for eSignature Integration

TL;DR: The BoldSign Python software development kit (SDK) adds electronic signatures to a Python app with a few lines of code. You install it with pip, set your API key and call one method to send a document for signature. Our Python SDK page shows what the SDK covers.

Say you run a Python app for a small consulting firm. Each new client must sign an agreement, and you want the app to send it and record when it comes back signed.

You could write each web request to an eSignature service by hand. We released the BoldSign Python SDK in November 2024 to do that work for you, so your code stays short.

What is the BoldSign Python SDK?

The BoldSign Python SDK is a free code library that wraps our eSignature API. You call Python methods, and the SDK builds and sends each request.

Think of a coffee machine with a button for each drink. You press one button and never see the pump, heater and timer at work. The SDK works the same way: you call send_document, and it handles the request behind it.

Is a Python digital signature SDK the same as an eSignature SDK?

Mostly, though the words differ. A digital signature is one type of electronic signature that uses certificates and encryption to show a file was not changed.

Most developers who look for a Python digital signature SDK want their users to sign a document online. Our guide to electronic signature vs digital signature explains the difference in more detail.

Why did we build a Python SDK?

Python is a common choice for automation, data work and web apps. We built the SDK so Python teams can add signing without writing their own wrapper code.

Without an SDK, each call needs your API key, the right address and the right data format. Sending, tracking and downloading a document also take separate calls. The SDK packs all of that into ready-made methods.

How do you install the BoldSign Python SDK?

Run one pip command in your project’s environment. The package is boldsign on PyPI, the Python Package Index.

pip install boldsign

The SDK needs Python 3.7 or later. Pip also installs the packages it depends on, such as pydantic and urllib3.

How do you set up your API key?

Create a free API sandbox account, then create an API key in the web app. Our API key guide shows each step.

Pass the key to a Configuration object, as the sample below shows. Keep the key in an environment variable or a config file, not in code you share.

Accounts in the US region need no other setting. For Europe, Canada or Australia, pass your region’s address as host, such as https://api-eu.boldsign.com.

How do you send a document for signature in Python?

Describe the signature field, the signer and the file, then call send_document. The response holds the new document’s ID.

import boldsign

# Configure API client with your API key
configuration = boldsign.Configuration(api_key="***your_api_key***")
# Initialize the API client and DocumentApi
with boldsign.ApiClient(configuration) as api_client:
    document_api = boldsign.DocumentApi(api_client)
    # Define the signature field
    signatureField = boldsign.FormField(
        fieldType="Signature",
        pageNumber=1,
        bounds=boldsign.Rectangle(x=100, y=100, width=100, height=50),
    )
    # Define the signer.
    signer = boldsign.DocumentSigner(
        name="David",
        emailAddress="david@example.com",
        signerType="Signer",
        formFields=[signatureField],
    )

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

    # Capture the API response.
    api_response = document_api.send_document(send_for_sign=send_for_sign)
    print("Document sent for signature, ID:", api_response.document_id)

The bounds set where the signature box sits on page 1. David then gets an email with a link to sign the agreement.

What else can the BoldSign Python SDK do?

The SDK groups its methods into classes, one for each part of the API. The main ones for signing are DocumentApi and TemplateApi.

  • Send a saved template with send_using_template.
  • Show the signing page inside your app with get_embedded_sign_link.
  • Check a document’s status with get_properties.
  • Download the signed PDF with download_document and the audit trail with download_audit_log.

Our send document documentation lists every option for a request. You can set signer order, reminders, expiry dates and more.

What should you watch out for?

Signers finish in their own time, so checking the status again and again wastes calls. A webhook tells your app the moment a document is signed instead.

  • Read our webhooks documentation to set one up.
  • Test every flow in the sandbox before you switch to live calls.
  • Keep your API key out of source control and logs.

Which plan do you need, and what does the BoldSign API cost?

Every BoldSign plan, including the free one, gives you sandbox API access for testing. Live API calls, embedded signing and webhooks need the Enterprise API plan, from $30 a month with 40 envelopes, billed yearly.

Each extra envelope on the Enterprise API plan costs $0.75. Prices are in USD, as of November 2026, and the pricing page lists every plan.

What can you build next with the BoldSign Python SDK?

The same few methods work for client agreements, offer letters, consent forms or any other document. Our eSignature API page shows the wider set of features you can reach from Python.

Frequently asked questions

Is there a Python SDK for electronic signatures?

Yes. We publish the boldsign package on the Python Package Index. You install it with pip and call our eSignature API through Python classes and methods.

How do I install the BoldSign Python SDK?

Run pip install boldsign in your project's environment. Then import boldsign in your script and pass your API key to a Configuration object.

Which Python versions does the BoldSign SDK support?

The SDK needs Python 3.7 or later. Pip installs the packages it depends on, such as pydantic and urllib3, for you.

Is a Python digital signature the same as an electronic signature?

Not quite. A digital signature is one type of electronic signature that uses certificates and encryption. Many developers use both words to mean signing a document online.

Are documents signed through the BoldSign Python SDK legally binding?

Yes, when the signing meets the electronic signature laws that apply to your document. Documents sent from Python go through the same signing steps and audit trail as the BoldSign web app.

Where is the source code for the BoldSign Python SDK?

The source code is public in our boldsign-python-sdk repository on GitHub, under a short open source license. The repository documents each class, method and data model.

Can I test the BoldSign API in Python for free?

Yes. A free API sandbox account gives you an API key for test documents. You can run all your Python code there before you send real documents.

How much does the BoldSign API cost for live documents?

Live API calls need the Enterprise API plan, from $30 a month with 40 envelopes, billed yearly in USD. Each extra envelope costs $0.75.

BoldSign Team

The official team behind BoldSign—the simple, secure eSignature solution trusted by businesses worldwide. Our platform helps individuals and teams create, sign, and manage documents effortlessly while maintaining full compliance. Experience BoldSign yourself with a free trial or request a personalized demo to see it in action.

More posts by BoldSign Team
Get started

Sign up for your free trial today!

Start free trial
  • 30-day free trial
  • No credit card required