contractsign

Python SDK for the ContractSign API. Create contracts, send them for digital signing, manage templates, and track signing status — all from Python.

Install

pip install contractsign

Quick start

from contractsign import ContractSign, CreateContractInput, CreateSigningInput, SignerInput, SignerRole, SigningMethod

client = ContractSign(api_key="cs_...")

# Create a contract
contract = client.contracts.create(CreateContractInput(
    title="Consulting Agreement",
    content="<h1>Consulting Agreement</h1><p>...</p>",
))
contract_id = contract["data"]["id"]

# Send for signing
signing = client.signing.create(CreateSigningInput(
    contract_id=contract_id,
    signers=[
        SignerInput(
            name="Jane Doe",
            email="jane@example.com",
            role=SignerRole.SIGNER,
            signing_method=SigningMethod.SMS_OTP,
            order=1,
        ),
    ],
))

print(f"Signing request created: {signing['data']['id']}")

Context manager

The client can be used as a context manager to ensure the HTTP connection is closed:

with ContractSign(api_key="cs_...") as client:
    contracts = client.contracts.list(limit=10)
    for contract in contracts["data"]:
        print(contract["title"])

Resources

Error handling

from contractsign import ContractSign, NotFoundError, AuthenticationError, ValidationError

client = ContractSign(api_key="cs_...")

try:
    contract = client.contracts.get("nonexistent-id")
except NotFoundError:
    print("Contract not found")
except AuthenticationError:
    print("Invalid API key")
except ValidationError as e:
    print(f"Invalid input: {e.message}")

Configuration

client = ContractSign(
    api_key="cs_...",
    base_url="https://contractsign.net",  # default
    timeout=30.0,                          # seconds, default
)

Types

All input and output types are available as dataclasses with full type hints:

from contractsign import (
    ContractStatus,
    SigningOrder,
    SignerRole,
    SigningMethod,
    CreateContractInput,
    CreateSigningInput,
    CreateTemplateInput,
    CreateFolderInput,
    CreateTagInput,
    CreatePartyInput,
    PartyType,
)

License

MIT