Esignature

Docuseal

Learn how to use Docuseal with Composio

Overview

SLUG: DOCUSEAL

Description

DocuSeal is a platform that provides a powerful and easy-to-use API to implement eSignature workflows, allowing users to automate document and template management processes without relying on the web interface.

Authentication Details

generic_api_key
stringRequired

Connecting to Docuseal

Create an auth config

Use the dashboard to create an auth config for the Docuseal toolkit. This allows you to connect multiple Docuseal accounts to Composio for agents to use.

1

Select App

Navigate to the Docuseal toolkit page and click “Setup Integration”.

2

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

3

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4docuseal_auth_config_id = "ac_YOUR_DOCUSEAL_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000"  # UUID from database/app
6
7composio = Composio()
8
9def authenticate_toolkit(user_id: str, auth_config_id: str):
10    # Replace this with a method to retrieve an API key from the user.
11    # Or supply your own.
12    user_api_key = input("[!] Enter API key")
13
14    connection_request = composio.connected_accounts.initiate(
15        user_id=user_id,
16        auth_config_id=auth_config_id,
17        config={"auth_scheme": "API_KEY", "val": user_api_key}
18    )
19
20    # API Key authentication is immediate - no redirect needed
21    print(f"Successfully connected Docuseal for user {user_id}")
22    print(f"Connection status: {connection_request.status}")
23    
24    return connection_request.id
25
26
27connection_id = authenticate_toolkit(user_id, docuseal_auth_config_id)
28
29# You can verify the connection using:
30connected_account = composio.connected_accounts.get(connection_id)
31print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Docuseal toolkit’s playground

Python
1from composio import Composio
2from openai import OpenAI
3import json
4
5openai = OpenAI()
6composio = Composio()
7
8# User ID must be a valid UUID format
9user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10
11tools = composio.tools.get(user_id=user_id, toolkits=["DOCUSEAL"])
12
13print("[!] Tools:")
14print(json.dumps(tools))
15
16def invoke_llm(task = "What can you do?"):
17    completion = openai.chat.completions.create(
18        model="gpt-4o",
19        messages=[
20            {
21                "role": "user",
22                "content": task,  # Your task here!
23            },
24        ],
25        tools=tools,
26    )
27
28    # Handle Result from tool call
29    result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30    print(f"[!] Completion: {completion}")
31    print(f"[!] Tool call result: {result}")
32
33invoke_llm()

Tool List

Tool Name: Archive Template

Description

Tool to archive a specific template by its unique identifier. use after verifying the template id.

Action Parameters

id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Clone Template

Description

Tool to clone an existing template by its id with a new name. use after you have the template id and desired name to duplicate it into the same or a different folder.

Action Parameters

folder_id
string
name
stringRequired
template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Submission From PDF

Description

Tool to create a one-off submission from a pdf file. use when you need to upload a pdf and initiate a signature workflow with optional custom field values and webhook notifications.

Action Parameters

email
fields
object
pdf
stringRequired
template_id
stringRequired
webhook_url

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Template from HTML

Description

Tool to create a template from html content. use when you need to define a reusable document template directly from html input.

Action Parameters

fields
array
html
stringRequired
name
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Template

Description

Tool to retrieve details of a specific template by its unique identifier. use when you need to fetch template metadata by id.

Action Parameters

template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Submissions

Description

Tool to list all document submissions with optional pagination and document filtering. use when you need to retrieve and browse existing submissions.

Action Parameters

document_id
string
limit
integer
offset
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Submitters

Description

Tool to retrieve a list of all submitters. use when you need a roster of submitters for reporting or management.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Templates

Description

Tool to retrieve a list of all templates. use when you need to browse available templates with optional filters before selection.

Action Parameters

after
integer
application_key
string
archived
boolean
before
integer
folder
string
limit
integer

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Merge Templates

Description

Tool to merge multiple templates into one with a new name. use when you have multiple template ids and want to combine them into a single document.

Action Parameters

output_name
string
template_ids
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Update Template

Description

Tool to update details of a specific template, including name and folder. use after confirming the template id.

Action Parameters

folder_id
string
name
string
template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired