Dropbox sign

Learn how to use Dropbox sign with Composio

Overview

SLUG: DROPBOX_SIGN

Description

Dropbox Sign (formerly HelloSign) offers electronic signature and document workflow solutions, simplifying how businesses collect legally binding signatures online

Authentication Details

client_id
stringRequired
client_secret
stringRequired
full
stringDefaults to https://api.hellosign.com/v3Required
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to basic_account_info,request_signature
bearer_token
string
basic_encoded
stringRequired

Connecting to Dropbox sign

Create an auth config

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

1

Select App

Navigate to [Dropbox sign](https://platform.composio.dev?next_page=/marketplace/Dropbox sign).

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 Dropbox sign Auth Config”. 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 OAuth2

1from composio import Composio
2
3# Replace these with your actual values
4dropbox_sign_auth_config_id = "ac_YOUR_DROPBOX_SIGN_CONFIG_ID" # Auth config ID created above
5user_id = "0000-0000-0000" # UUID from database/application
6
7composio = Composio()
8
9
10def authenticate_toolkit(user_id: str, auth_config_id: str):
11 connection_request = composio.connected_accounts.initiate(
12 user_id=user_id,
13 auth_config_id=auth_config_id,
14 )
15
16 print(
17 f"Visit this URL to authenticate Dropbox sign: {connection_request.redirect_url}"
18 )
19
20 # This will wait for the auth flow to be completed
21 connection_request.wait_for_connection(timeout=15)
22 return connection_request.id
23
24
25connection_id = authenticate_toolkit(user_id, dropbox_sign_auth_config_id)
26
27# You can also verify the connection status using:
28connected_account = composio.connected_accounts.get(connection_id)
29print(f"Connected account: {connected_account}")

Using API Key

1from composio import Composio
2
3# Replace these with your actual values
4dropbox_sign_auth_config_id = "ac_YOUR_DROPBOX_SIGN_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": {"generic_api_key": user_api_key}}
18 )
19
20 # API Key authentication is immediate - no redirect needed
21 print(f"Successfully connected Dropbox sign 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, dropbox_sign_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 [Dropbox sign toolkit’s playground](https://app.composio.dev/app/Dropbox sign)

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=["DROPBOX_SIGN"])
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: Invite User to Team

Description

Tool to invite a user to your Team. Use when you need to add a member by email or account ID.

Action Parameters

account_id
string
email_address
string
role
string
team_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Add User to Template

Description

Tool to grant a specified account access to a template. Use when you need to share a template with another user after confirming template and account identifiers.

Action Parameters

account_id
string
email_address
string
skip_notification
boolean
template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Bulk send with template

Description

Tool to create a BulkSendJob for templated signature requests. Use when you need to send up to 250 signature requests at once via one or more templates.

Action Parameters

allow_decline
boolean
ccs
array
client_id
string
custom_fields
array
message
string
metadata
object
signer_file
object
signer_list
array
signing_redirect_url
string
subject
string
template_ids
arrayRequired
test_mode
boolean
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Create Report

Description

Tool to request creation of CSV report(s). Use when you need account activity or document status reports for a specific date range.

Action Parameters

end_date
stringRequired
report_type
arrayRequired
start_date
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Delete Template

Description

Tool to permanently delete a template. Use when you need to remove a template after confirming its ID.

Action Parameters

template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Download Signature Request Files

Description

Tool to download documents for a signature request. Use after confirming the request is complete; returns a PDF or ZIP file.

Action Parameters

file_type
stringDefaults to pdf
signature_request_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Edit and Resend Embedded Signature Request

Description

Tool to edit and resend an embedded signature request. Use when you need to modify and restart the embedded signing flow for an existing request.

Action Parameters

allow_decline
boolean
allow_reassign
boolean
attachments
array
cc_email_addresses
array
client_id
stringRequired
custom_fields
array
expires_at
integer
field_options
object
file_urls
array
files
array
grouped_signers
array
hide_text_tags
boolean
message
string
metadata
object
populate_auto_fill_fields
boolean
signature_request_id
stringRequired
signers
array
signing_options
object
subject
string
test_mode
boolean
title
string
use_text_tags
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Edit and Resend Embedded Signature Request With Template

Description

Tool to edit and resend an embedded signature request using templates. Use when you need to update request details or recipients and resend within an embedded signing flow.

Action Parameters

allow_decline
boolean
ccs
array
client_id
stringRequired
custom_fields
array
file_urls
array
files
array
message
string
metadata
object
populate_auto_fill_fields
boolean
signature_request_id
stringRequired
signers
arrayRequired
signing_options
object
subject
string
template_ids
arrayRequired
test_mode
boolean
title
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Edit and Resend Signature Request

Description

Tool to edit and resend a signature request. Use when you need to update documents, signers, or metadata and resend an existing non-templated request.

Action Parameters

allow_decline
boolean
allow_reassign
boolean
attachments
array
cc_email_addresses
array
client_id
string
custom_fields
array
expires_at
integer
field_options
object
file_urls
array
files
array
form_field_groups
array
form_field_rules
array
form_fields_per_document
array
grouped_signers
array
hide_text_tags
boolean
is_eid
boolean
message
string
metadata
object
signature_request_id
stringRequired
signers
array
signing_options
object
signing_redirect_url
string
subject
string
test_mode
boolean
title
string
use_text_tags
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Edit and Resend Unclaimed Draft

Description

Tool to edit and resend a previously created unclaimed draft. Use when you have an existing signature_request_id and want to modify the draft before reissuing.

Action Parameters

client_id
stringRequired
editor_options
object
is_for_embedded_signing
boolean
requester_email_address
string
requesting_redirect_url
string
show_progress_stepper
booleanDefaults to True
signature_request_id
stringRequired
signing_redirect_url
string
test_mode
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Dropbox Sign Account

Description

Tool to retrieve the properties and settings of your Dropbox Sign account. Use when you need to inspect account details. Requires either account_id or email_address.

Action Parameters

account_id
string
email_address
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Bulk Send Job

Description

Tool to retrieve the status of a bulk send job. Use when you need up-to-date job progress and request details.

Action Parameters

bulk_send_job_id
stringRequired
page
integerDefaults to 1
page_size
integerDefaults to 20

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Current Team Membership

Description

Tool to get the current team membership status and details. Use when you need to check if the authenticated user is part of a team and retrieve team information. Returns is_on_team False if user is not part of any team (no retries needed for this case).

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Embedded Sign URL

Description

Tool to generate an embedded signing URL for a signature. Use after creating a signature request when embedding HelloSign in an iFrame.

Action Parameters

signature_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Embedded Template Edit URL

Description

Tool to generate an edit URL for embedded template editing. Use after selecting or uploading a template to allow users to modify it in an iframe.

Action Parameters

allow_edit_ccs
boolean
cc_roles
array
editor_options
object
force_signer_roles
boolean
force_subject_message
boolean
merge_fields
array
preview_only
boolean
show_preview
boolean
show_progress_stepper
booleanDefaults to True
template_id
stringRequired
test_mode
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Signature Request

Description

Tool to get the status and details of a signature request. Use when you need to retrieve up-to-date information after sending a request.

Action Parameters

signature_request_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Team Info

Description

Tool to get information about a team. Use when you need to retrieve details of a team by its ID.

Action Parameters

team_id
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Get Template

Description

Tool to return the specified template. Use when you need to fetch full template details by ID.

Action Parameters

template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Download Template Files

Description

Tool to download documents associated with a template. Use after confirming the template is created; returns a PDF or ZIP archive of the documents.

Action Parameters

file_type
stringDefaults to pdf
template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Bulk Send Jobs

Description

Tool to list bulk send jobs. Use when you need to retrieve all bulk send job summaries the authenticated user can access. Supports pagination via page and page_size.

Action Parameters

page
integerDefaults to 1
page_size
integerDefaults to 20

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Fax Lines

Description

Tool to list fax lines and their properties. Use when you need to retrieve available fax lines for an account, optionally paging or including team lines.

Action Parameters

account_id
string
page
integerDefaults to 1
page_size
integerDefaults to 20
show_team_lines
boolean

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Signature Requests

Description

Tool to list signature requests. Use when you need to retrieve paginated signature requests with optional filters.

Action Parameters

account_id
string
page
integerDefaults to 1
page_size
integerDefaults to 20
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Sub-Teams

Description

Tool to list sub-teams of a parent team. Use when you need to retrieve all sub-teams under a given team with pagination support.

Action Parameters

page
integerDefaults to 1
page_size
integerDefaults to 20
team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Team Members

Description

Tool to list members and roles for a team. Use after you have a valid team_id to view its members and their roles.

Action Parameters

page
integerDefaults to 1
page_size
integerDefaults to 20
team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List All Teams

Description

Tool to list all teams available to the user. Use after authenticating to retrieve the current team and its sub-teams, returning their team_ids and names for downstream actions.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: List Templates

Description

Tool to list templates. Use when you need to retrieve a paginated list of templates accessible to your account.

Action Parameters

account_id
string
page
integerDefaults to 1
page_size
integerDefaults to 20
query
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Generate OAuth Authorization URL

Description

Tool to generate an OAuth authorization URL. Use before directing the user to grant access.

Action Parameters

client_id
string
redirect_uri
string
scope
string
state
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Release Signature Request Hold

Description

Tool to release a held signature request. Use when a signature request created from an unclaimed draft is held and you want to send it to signers.

Action Parameters

signature_request_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Remove User from Template

Description

Tool to remove an account's access to a template. Use when you need to revoke a user's permission on a template after confirming template ID and target account.

Action Parameters

account_id
string
email_address
string
template_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Send Request Reminder

Description

Tool to send an email reminder to a signer. Use when you need to remind a signer about an outstanding signature request at least 1 hour after the last reminder.

Action Parameters

email_address
stringRequired
name
string
signature_request_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

Tool Name: Verify Dropbox Sign Account

Description

Tool to verify whether a Dropbox Sign account exists for the given email. Use when you need to check account existence before sending signature requests.

Action Parameters

email_address
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired