# Dropbox Sign

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

- **Category:** signatures
- **Auth:** API_KEY, OAUTH2
- **Composio Managed App Available?** No
- **Tools:** 56
- **Triggers:** 0
- **Slug:** `DROPBOX_SIGN`
- **Version:** 20260309_00

## Tools

### Invite User to Team

**Slug:** `DROPBOX_SIGN_ADD_USER_TO_TEAM`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `role` | string ("Member" | "Developer" | "Team Manager" | "Admin") | No | Role to assign to the invited user. Allowed values: Member, Developer, Team Manager, Admin. |
| `team_id` | string | No | The ID of the team to which the user will be invited. |
| `account_id` | string | No | The account ID of the user to invite. If provided, takes precedence over email_address. |
| `email_address` | string | No | The email address of the user to invite. Required if account_id is not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add User to Template

**Slug:** `DROPBOX_SIGN_ADD_USER_TO_TEMPLATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | No | ID of the account to grant access (must be 40 characters long). Takes precedence over email_address. |
| `template_id` | string | Yes | ID of the template to share |
| `email_address` | string | No | Email of the account to grant access. Ignored if account_id is provided. |
| `skip_notification` | boolean | No | If true, suppresses the email notification sent when sharing the template. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk create embedded signature request with template

**Slug:** `DROPBOX_SIGN_BULK_CREATE_EMBEDDED_SIG_REQ_WITH_TEMPLATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ccs` | array | No | CC recipients; required if template defines CC roles |
| `title` | string | No | Optional internal title for the job |
| `message` | string | No | Custom email message to signers |
| `subject` | string | No | Custom email subject line |
| `metadata` | object | No | Up to 10 key/value pairs to be returned in events; keys ≤40 chars, values ≤1000 chars |
| `client_id` | string | Yes | Client ID of the application creating the embedded request |
| `test_mode` | boolean | No | If true, the request is not legally binding |
| `signer_file` | object | No | CSV file with signer data: columns name,email_address,optional pin,sms_phone_number, and any *_field for custom fields. Required unless signer_list is provided. |
| `signer_list` | array | No | Structured list of signers and custom fields. Required unless signer_file is provided. |
| `template_ids` | array | Yes | List of template IDs in the order they should be applied |
| `allow_decline` | boolean | No | Allow signers to decline the request |
| `custom_fields` | array | No | Global template merge fields to prefill |
| `signing_redirect_url` | string | No | URL to redirect signers after signing completes |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk send with template

**Slug:** `DROPBOX_SIGN_BULK_SEND_WITH_TEMPLATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ccs` | array | No | CC recipients; required if template defines CC roles |
| `title` | string | No | Optional internal title for the job |
| `message` | string | No | Custom email message to signers |
| `subject` | string | No | Custom email subject line |
| `metadata` | object | No | Up to 10 key/value pairs to be returned in events; keys ≤40 chars, values ≤1000 chars |
| `client_id` | string | No | API App client_id for branding and callbacks |
| `test_mode` | boolean | No | If true, the request is not legally binding |
| `signer_file` | object | No | CSV file with signer data: columns name,email_address,optional pin,sms_phone_number, and any *_field for custom fields. Required unless signer_list is provided. |
| `signer_list` | array | No | Structured list of signers and custom fields. Required unless signer_file is provided. |
| `template_ids` | array | Yes | List of template IDs in the order they should be applied |
| `allow_decline` | boolean | No | Allow signers to decline the request |
| `custom_fields` | array | No | Global template merge fields to prefill |
| `signing_redirect_url` | string | No | URL to redirect signers after signing completes |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Cancel Signature Request

**Slug:** `DROPBOX_SIGN_CANCEL_SIGNATURE_REQUEST`

Cancels an incomplete signature request. Use when you need to cancel a pending signature request that has not been completed. The operation is asynchronous and not reversible - once canceled, the signature request cannot be restored.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `signature_request_id` | string | Yes | The id of the SignatureRequest to cancel. Must be a valid signature request ID (40-character hexadecimal string). Note: This operation is asynchronous and not reversible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Dropbox Sign Account

**Slug:** `DROPBOX_SIGN_CREATE_ACCOUNT`

Tool to create a new Dropbox Sign account associated with a specified email address. Use when you need to programmatically register new users in the Dropbox Sign platform.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locale` | string | No | The locale for the account. Defaults to 'en_US' if not specified. |
| `client_id` | string | No | Used for OAuth account creation. The Client ID for your API App. |
| `client_secret` | string | No | Used for OAuth account creation. The Client Secret for your API App. |
| `email_address` | string | Yes | The email address which will be associated with the new Dropbox Sign account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create API App

**Slug:** `DROPBOX_SIGN_CREATE_API_APP`

Tool to create a new Dropbox Sign API App. Use when you need to register a new application for API integration. The app will have a client_id for authentication and can be configured with OAuth, callbacks, and white labeling.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The name to assign to the API App. |
| `oauth` | object | No | OAuth configuration for the API App. |
| `domains` | array | Yes | List of domain names associated with the app (hostname only, without protocol). Use when the app will be accessed from specific domains. |
| `options` | object | No | Options for the API App. |
| `callback_url` | string | No | URL where event callbacks will be sent. Use when you need to receive notifications about signature request events. |
| `white_labeling_options` | object | No | White labeling customization options for the API App. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Embedded Signature Request

**Slug:** `DROPBOX_SIGN_CREATE_EMBEDDED_SIGNATURE_REQUEST`

Tool to create an embedded signature request for signing in an iFrame. Use when you need to initiate a signature request that will be signed within your application rather than via email links.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Document files to be signed (multipart upload). Use files or file_urls, not both. |
| `title` | string | No | Title displayed in the signature interface |
| `message` | string | No | Custom message included in signer emails |
| `signers` | array | Yes | List of signer objects with name, email, and optional order |
| `subject` | string | No | Email subject line for signature request |
| `metadata` | object | No | Up to 10 custom key/value metadata entries (keys <=40 chars, values <=1000 chars) |
| `client_id` | string | Yes | Client ID for embedded signing (must be exactly 32 characters). Get this from your API app settings at sign.dropbox.com |
| `file_urls` | array | No | URLs to documents to be signed; Dropbox Sign will fetch. Use file_urls or files, not both. |
| `test_mode` | boolean | No | Whether request operates in sandbox mode (default false) |
| `expires_at` | integer | No | Unix timestamp when request expires; unsigned requests move to expired |
| `attachments` | array | No | Signer attachments to collect |
| `allow_decline` | boolean | No | Allow signers to decline (default false) |
| `custom_fields` | array | No | Custom field values for merge fields or text tags |
| `field_options` | object | No | Field formatting options. |
| `use_text_tags` | boolean | No | Enable text tags parsing in documents |
| `allow_reassign` | boolean | No | Allow signers to reassign (premium feature, default false) |
| `hide_text_tags` | boolean | No | Remove text tags in the final document |
| `signing_options` | object | No | Signature creation method options. |
| `cc_email_addresses` | array | No | Email addresses to CC on the request |
| `populate_auto_fill_fields` | boolean | No | Allow auto-fill fields to pre-populate signer info during signing |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Embedded Signature Request With Template

**Slug:** `DROPBOX_SIGN_CREATE_EMBEDDED_SIGNATURE_REQUEST_WITH_TEMPLATE`

Tool to create an embedded signature request based on a template. Use when you need to initiate a new signature request for embedded signing using pre-defined templates. Returns signature request details including signing URLs for embedded iFrame integration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ccs` | array | No | CC recipients matching any CC roles in template |
| `files` | array | No | Binary file uploads; mutually exclusive with file_urls |
| `title` | string | No | Title for the signature request (max 255 chars) |
| `message` | string | No | Custom email message to signers (max 5000 chars) |
| `signers` | array | Yes | Signer definitions matching template roles |
| `subject` | string | No | Email subject to signers (max 255 chars) |
| `metadata` | object | No | Key/value metadata (≤10 keys, values ≤1000 chars) |
| `client_id` | string | Yes | Client ID of your Dropbox Sign app for embedded requests (must be exactly 32 characters) |
| `file_urls` | array | No | URLs for Dropbox Sign to fetch file(s); mutually exclusive with files |
| `test_mode` | boolean | No | If true, signature request is a non-legally binding test |
| `template_ids` | array | Yes | One or more template IDs to use for the signature request |
| `allow_decline` | boolean | No | Allow signers to decline |
| `custom_fields` | array | No | Values for merge fields in template |
| `signing_options` | object | No | Signing method options for signature requests. |
| `populate_auto_fill_fields` | boolean | No | If true, auto-fill fields are pre-populated during embedded signing |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Embedded Template Draft

**Slug:** `DROPBOX_SIGN_CREATE_EMBEDDED_TEMPLATE_DRAFT`

Tool to create an embedded template draft. Use when initiating an embedded template workflow where users can edit the template in an iframe before finalizing it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | List of PDF files to upload. Either files or file_urls must be provided. |
| `title` | string | No | Title for the template |
| `message` | string | No | Message to be included with the template |
| `subject` | string | No | Subject line for the template |
| `cc_roles` | array | No | Array of CC role names |
| `metadata` | object | No | Key-value data to be returned in callbacks and webhooks |
| `allow_ccs` | boolean | No | Allow users to add CC recipients when sending |
| `client_id` | string | Yes | Client ID from your API App. Required for embedded template workflow. |
| `file_urls` | array | No | Array of publicly accessible URLs for PDF files. Either files or file_urls must be provided. |
| `test_mode` | boolean | No | Whether this is a test (true for test, false for production) |
| `skip_me_now` | boolean | No | Skip the current user in the signing order |
| `merge_fields` | array | No | Array of merge field objects |
| `show_preview` | boolean | No | Show preview before sending |
| `signer_roles` | array | No | Array of signer role objects with name and order |
| `allow_reassign` | boolean | No | Allow signers to reassign the signature request |
| `show_progress_stepper` | boolean | No | Show progress stepper in the embedded UI |
| `use_preexisting_fields` | boolean | No | Enable to auto-detect fields from the document |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Embedded Unclaimed Draft with Template

**Slug:** `DROPBOX_SIGN_CREATE_EMBEDDED_UNCLAIMED_DRAFT_WITH_TEMPLATE`

Tool to create an embedded unclaimed draft using saved templates. Use when you need to create a draft that can be claimed and embedded in an iFrame for signature collection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ccs` | array | No | CC recipients; required if template defines CC roles |
| `title` | string | No | Optional internal title for the draft |
| `message` | string | No | Custom email message to signers |
| `signers` | array | Yes | List of signers for the signature request; order and roles must match template requirements |
| `subject` | string | No | Custom email subject line |
| `metadata` | object | No | Up to 10 key/value pairs to be returned in events; keys ≤40 chars, values ≤1000 chars |
| `client_id` | string | Yes | Client ID of the app used to create the draft; applies app branding and callback URL (must be exactly 32 characters) |
| `test_mode` | boolean | No | If true, the request is not legally binding |
| `skip_me_now` | boolean | No | Skip the current user's signature step if they are a signer |
| `show_preview` | boolean | No | Enable preview mode in the embedded editor |
| `template_ids` | array | Yes | List of template IDs to use for creating the draft; must contain at least one template ID |
| `allow_decline` | boolean | No | Allow signers to decline the signature request |
| `custom_fields` | array | No | Template merge fields to prefill |
| `field_options` | object | No | Additional field-level options for form fields |
| `editor_options` | object | No | Options to configure the embedded editor UI. |
| `force_signer_roles` | boolean | No | Force signers to use specific roles defined in template |
| `signing_redirect_url` | string | No | URL to redirect signers after they successfully sign |
| `force_subject_message` | boolean | No | Force use of subject and message from template |
| `show_progress_stepper` | boolean | No | Show progress stepper; set to false to hide when only one step remains |
| `is_for_embedded_signing` | boolean | No | If true, the resulting signature request will be signable in embedded mode |
| `requester_email_address` | string | Yes | Email address of the requester who will be designated as the sender of the signature request |
| `requesting_redirect_url` | string | No | URL to redirect users after they successfully request a signature |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Report

**Slug:** `DROPBOX_SIGN_CREATE_REPORT`

Request creation of CSV report(s) for a specified date range. Reports are generated asynchronously and delivered via email. Available report types: user_activity (account activity), document_status (signature request status), sms_activity (SMS delivery info). You can request up to 2 report types per call. Date range can be up to 12 months, with start_date no more than 10 years in the past. Note: This feature may require a paid plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | Inclusive end date in MM/DD/YYYY format. |
| `start_date` | string | Yes | Inclusive start date in MM/DD/YYYY format. Date range may be up to 12 months; start_date must not be more than 10 years in the past. |
| `report_type` | array | Yes | Type(s) of report to create. Allowed values: 'user_activity', 'document_status', 'sms_activity'. Up to two report types may be requested. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Template

**Slug:** `DROPBOX_SIGN_CREATE_TEMPLATE`

Tool to create a reusable template for document signing workflows. Use when you need to establish a template with pre-defined form fields, signer roles, and documents.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | PDF files to upload for the template. At least one file source (files or file_urls) required. |
| `title` | string | Yes | The template's name |
| `message` | string | No | Email message body for signature requests |
| `subject` | string | No | Email subject line for signature requests |
| `cc_roles` | array | No | CC recipient role names |
| `metadata` | object | No | Key-value metadata attached to the template (max 10 pairs) |
| `client_id` | string | No | Client account identifier for template association |
| `file_urls` | array | No | URLs pointing to existing PDFs. At least one file source (files or file_urls) required. |
| `test_mode` | boolean | No | Whether to create in test/sandbox mode |
| `skip_me_now` | boolean | No | Skip creator from signing even if included in signer roles |
| `signer_roles` | array | No | Defines signer role names and signing order. Required if form fields reference signers. |
| `use_preexisting_fields` | boolean | No | Use pre-existing form fields from uploaded PDF if available |
| `form_fields_per_document` | array | Yes | Required array of form field objects defining where and how fields appear. At least one field required. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Unclaimed Draft

**Slug:** `DROPBOX_SIGN_CREATE_UNCLAIMED_DRAFT`

Tool to create an unclaimed draft that can be claimed via a unique URL. Use when you need to prepare a signature request or document send that will be finalized later by someone else through the claim URL.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("send_document" | "request_signature") | Yes | Draft type: 'send_document' allows document sending without signatures, 'request_signature' requires signers and enables signature collection |
| `files` | array | No | PDF/document files to upload; use files or file_urls, not both. |
| `message` | string | No | Custom message included in signature request email |
| `signers` | array | No | Array of signer objects with name, email_address, and order; required when type is 'request_signature' |
| `subject` | string | No | Email subject line for the signature request |
| `metadata` | object | No | Custom key-value metadata (up to 10 pairs; keys ≤40 chars, values ≤1000 chars) |
| `client_id` | string | No | API app client ID for applying custom branding and callback URL |
| `file_urls` | array | No | URLs pointing to documents for Dropbox Sign to fetch; use file_urls or files, not both. |
| `test_mode` | boolean | No | If true, the draft/request will be in test mode and not legally binding |
| `allow_decline` | boolean | No | Allow signers to decline signing the request |
| `use_text_tags` | boolean | No | Enable parsing of text tags in uploaded documents |
| `allow_reassign` | boolean | No | Allow signers to reassign the signature request to another person |
| `hide_text_tags` | boolean | No | Remove text tags from final signed document if set to true |
| `form_field_rules` | array | No | Conditional logic rules controlling field visibility based on other field values |
| `form_field_groups` | array | No | Form field group definitions for organizing related fields together |
| `cc_email_addresses` | array | No | Email addresses to receive a copy of all signer emails |
| `signing_redirect_url` | string | No | URL to redirect signers after completing signature |
| `show_progress_stepper` | boolean | No | Display progress stepper UI; set to false to hide |
| `use_preexisting_fields` | boolean | No | Set to true to enable auto-detection of merge fields from the document; only applicable for 'send_document' type |
| `requesting_redirect_url` | string | No | URL to redirect the requester after finalizing the draft (for embedded flows) |
| `form_fields_per_document` | array | No | Predefined form field placements across uploaded documents; each entry defines fields for one document |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete API App

**Slug:** `DROPBOX_SIGN_DELETE_API_APP`

Tool to delete an API App from your Dropbox Sign account by its client_id. Use when you need to remove an API App that is no longer needed. The API App must be owned by the requesting user.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | Yes | The client ID of the API App to delete. This must be an API App owned by the requesting user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Fax

**Slug:** `DROPBOX_SIGN_DELETE_FAX`

Tool to delete a fax from the system by its fax_id. Use when you need to remove a fax from Dropbox Sign. Returns success if the fax is deleted or doesn't exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fax_id` | string | Yes | The ID of the Fax to delete from the system. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Template

**Slug:** `DROPBOX_SIGN_DELETE_TEMPLATE`

Permanently deletes a template from your Dropbox Sign account by its template_id. Once deleted, the template cannot be recovered. Use this when you need to remove outdated or unused templates. Returns success if template is deleted or doesn't exist.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | The ID of the template to permanently delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Signature Request Files

**Slug:** `DROPBOX_SIGN_DOWNLOAD_SIGNATURE_REQUEST_FILES`

Download files for a signature request as PDF (merged) or ZIP (individual documents). Returns immediately if files are ready, or indicates if files are still being prepared (409 status).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_type` | string ("pdf" | "zip") | No | Output format: 'pdf' for merged PDF or 'zip' for individual documents. |
| `signature_request_id` | string | Yes | ID of the SignatureRequest to download documents for. Example: fa5c8a0b...967 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit and Resend Embedded Signature Request

**Slug:** `DROPBOX_SIGN_EDIT_AND_RESEND_EMBEDDED_SIGNATURE_REQUEST`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Files to upload; use files or file_urls, not both. |
| `title` | string | No | Title for the signature request |
| `message` | string | No | Custom message to signers |
| `signers` | array | No | List of signer definitions; use signers or grouped_signers, not both. |
| `subject` | string | No | Email subject for signers |
| `metadata` | object | No | Up to 10 custom key/value metadata entries (keys <=40 chars, values <=1000 chars) |
| `client_id` | string | Yes | Client ID for embedded signing (must be exactly 32 characters). Get this from your API app settings at sign.dropbox.com |
| `file_urls` | array | No | URLs for files; Dropbox Sign will fetch. Use file_urls or files, not both. |
| `test_mode` | boolean | No | If true, this is a test (non-binding) request |
| `expires_at` | integer | No | Unix timestamp when request expires; unsigned requests move to expired |
| `attachments` | array | No | Signer attachments to collect |
| `allow_decline` | boolean | No | Allow signers to decline (default false) |
| `custom_fields` | array | No | Custom field values for merge fields or text tags |
| `field_options` | object | No | Request-level field options |
| `use_text_tags` | boolean | No | Enable text tags parsing in documents |
| `allow_reassign` | boolean | No | Allow signers to reassign (premium feature, default false) |
| `hide_text_tags` | boolean | No | Remove text tags in the final document |
| `grouped_signers` | array | No | List of grouped signer definitions; use grouped_signers or signers, not both. |
| `signing_options` | object | No | Allowed signature creation types |
| `cc_email_addresses` | array | No | Email addresses to CC on the request |
| `signature_request_id` | string | Yes | ID of the signature request to edit and resend (must be exactly 40 characters) |
| `populate_auto_fill_fields` | boolean | No | Allow auto-fill fields to pre-populate signer info during signing |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit and Resend Signature Request

**Slug:** `DROPBOX_SIGN_EDIT_AND_RESEND_SIGNATURE_REQUEST`

Edits and resends an existing non-templated signature request with updated documents, signers, or settings. Use this tool when you need to modify an already-created signature request and resend it to signers. Note: This will reset signatures - anyone who already signed will need to sign again. Important: Edit and resend operations deduct from your signature request quota. Required: You must provide either 'files' or 'file_urls' (not both) and either 'signers' or 'grouped_signers' (not both).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Files to upload; use files or file_urls, not both. |
| `title` | string | No | Title for the signature request |
| `is_eid` | boolean | No | Require eID identity verification (premium feature) |
| `message` | string | No | Custom email message to signers |
| `signers` | array | No | List of signer definitions; use signers or grouped_signers, not both. |
| `subject` | string | No | Custom email subject line |
| `metadata` | object | No | Up to 10 custom key/value metadata entries (keys ≤40 chars, values ≤1000 chars) |
| `client_id` | string | No | API App client_id for branding and callbacks |
| `file_urls` | array | No | URLs for files; Dropbox Sign will fetch. Use file_urls or files, not both. |
| `test_mode` | boolean | No | If true, the request is not legally binding |
| `expires_at` | integer | No | Unix timestamp when request expires |
| `attachments` | array | No | Signer attachments to collect |
| `allow_decline` | boolean | No | Allow signers to decline the request |
| `custom_fields` | array | No | Custom field values for merge fields or text tags |
| `field_options` | object | No | Request-level field options |
| `use_text_tags` | boolean | No | Enable text tags parsing in documents |
| `allow_reassign` | boolean | No | Allow signers to reassign (premium feature) |
| `hide_text_tags` | boolean | No | Remove text tags in the final document |
| `grouped_signers` | array | No | List of grouped signer definitions; use grouped_signers or signers, not both. |
| `signing_options` | object | No | Allowed signature creation types |
| `form_field_rules` | array | No | Conditional logic rules for form fields |
| `form_field_groups` | array | No | Definitions for form field groups referenced by fields |
| `cc_email_addresses` | array | No | Email addresses to CC on the request |
| `signature_request_id` | string | Yes | ID of the signature request to edit and resend |
| `signing_redirect_url` | string | No | URL to redirect signers after signing completes |
| `form_fields_per_document` | array | No | Form fields placement per document |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit and Resend Unclaimed Draft

**Slug:** `DROPBOX_SIGN_EDIT_AND_RESEND_UNCLAIMED_DRAFT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | Yes | Client ID of the app used to create the draft; applies app branding and callback URL (must be exactly 32 characters) |
| `test_mode` | boolean | No | If true, created request is not legally binding |
| `editor_options` | object | No | Options for the built-in document editor while preparing the draft |
| `signature_request_id` | string | Yes | ID of the signature request to edit and resend (must be exactly 40 characters) |
| `signing_redirect_url` | string | No | URL to redirect signers after they successfully sign |
| `show_progress_stepper` | boolean | No | Show progress stepper; set to false to hide when only one step remains |
| `is_for_embedded_signing` | boolean | No | If true, the resulting request will be signable in embedded mode |
| `requester_email_address` | string | No | Email to designate as the requester; defaults to the original requester if not set |
| `requesting_redirect_url` | string | No | URL to redirect users after they successfully request a signature |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Edit and Resend Embedded Signature Request With Template

**Slug:** `DROPBOX_SIGN_EDIT_RESEND_EMBEDDED_SIGNATURE_REQUEST_TEMPLATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ccs` | array | No | CC recipients matching any CC roles in template |
| `files` | array | No | Binary file uploads; mutually exclusive with file_urls |
| `title` | string | No | Title for the signature request (max 255 chars) |
| `message` | string | No | Custom email message to signers (max 5000 chars) |
| `signers` | array | Yes | Signer definitions matching template roles |
| `subject` | string | No | Email subject to signers (max 255 chars) |
| `metadata` | object | No | Key/value metadata (≤10 keys, values ≤1000 chars) |
| `client_id` | string | Yes | Client ID of your HelloSign app for embedded requests (must be exactly 32 characters) |
| `file_urls` | array | No | URLs for Dropbox Sign to fetch file(s); mutually exclusive with files |
| `test_mode` | boolean | No | If true, signature request is a non-legally binding test |
| `template_ids` | array | Yes | One or more template IDs in order |
| `allow_decline` | boolean | No | Allow signers to decline |
| `custom_fields` | array | No | Values for merge fields in template |
| `signing_options` | object | No | Override account signing method options |
| `signature_request_id` | string | Yes | The ID of the signature request to edit and resend (must be exactly 40 characters) |
| `populate_auto_fill_fields` | boolean | No | If true, auto-fill fields are pre-populated during embedded signing |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dropbox Sign Account

**Slug:** `DROPBOX_SIGN_GET_ACCOUNT`

Retrieves detailed information about a Dropbox Sign account including quotas, payment status, and settings. Use this tool to: - Check account quota limits (API requests, documents, templates remaining) - Verify account payment status (paid vs free tier) - Get account settings (SMS delivery, authentication options) - Retrieve account identifiers and contact information Requires either account_id (40-character identifier) or email_address, but not both.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | No | The ID of the account (must be exactly 40 characters). Provide either account_id or email_address, but not both. |
| `email_address` | string | No | The email address of the account. Provide either account_id or email_address, but not both. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API App

**Slug:** `DROPBOX_SIGN_GET_API_APP`

Tool to retrieve information about an API App by its client ID. Use when you need to fetch API App configuration, OAuth settings, white labeling options, or owner details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | Yes | The client ID of the API App to retrieve. This unique identifier is assigned when the app is created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bulk Send Job

**Slug:** `DROPBOX_SIGN_GET_BULK_SEND_JOB`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number of the Bulk Send Job signature requests to return. Defaults to 1. |
| `page_size` | integer | No | Number of signature requests per page (1-100). Defaults to 20. |
| `bulk_send_job_id` | string | Yes | The ID of the Bulk Send Job to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Team Membership

**Slug:** `DROPBOX_SIGN_GET_CURRENT_TEAM`

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).

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Embedded Sign URL

**Slug:** `DROPBOX_SIGN_GET_EMBEDDED_SIGN_URL`

Retrieves an embedded signing URL for a specific signer's signature. Use this after creating an embedded signature request to get a temporary URL that can be embedded in an iFrame for the signer to complete signing. The URL expires after 60 minutes or upon first access, but you can generate a new URL anytime using the same signature_id. Note: Requires the signature_id (per signer), not the signature_request_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `signature_id` | string | Yes | The 32-character signature ID (not signature_request_id) obtained from creating an embedded signature request. Each signer has a unique signature_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Embedded Template Edit URL

**Slug:** `DROPBOX_SIGN_GET_EMBEDDED_TEMPLATE_EDIT_URL`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cc_roles` | array | No | List of CC role names; pass empty list to remove all CC roles. |
| `test_mode` | boolean | No | Allow editing locked templates when in test mode. |
| `template_id` | string | Yes | ID of the template to generate an edit URL for. |
| `merge_fields` | array | No | Merge fields to prefill; pass empty list to clear all existing. |
| `preview_only` | boolean | No | Preview-only mode with no adding fields; overrides show_preview. |
| `show_preview` | boolean | No | Enable the editor preview experience. |
| `allow_edit_ccs` | boolean | No | Allow adding or changing CC roles during editing. |
| `editor_options` | object | No | Options to configure the embedded template editor UI. |
| `force_signer_roles` | boolean | No | Allow users to review or edit signer roles before sending. |
| `force_subject_message` | boolean | No | Allow users to review or edit email subject and message. |
| `show_progress_stepper` | boolean | No | Show the progress stepper unless only one step remains. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Available Fax Line Area Codes

**Slug:** `DROPBOX_SIGN_GET_FAX_LINE_AREA_CODES`

Tool to retrieve available fax line area codes for a given country, state/province, and city. Use when you need to determine which area codes are available for purchasing or provisioning a fax line in a specific location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `city` | string | No | Filter area codes by city name. Narrows results to a specific city within the selected state or province. |
| `state` | string ("AK" | "AL" | "AR" | "AZ" | "CA" | "CO" | "CT" | "DC" | "DE" | "FL" | "GA" | "HI" | "IA" | "ID" | "IL" | "IN" | "KS" | "KY" | "LA" | "MA" | "MD" | "ME" | "MI" | "MN" | "MO" | "MS" | "MT" | "NC" | "ND" | "NE" | "NH" | "NJ" | "NM" | "NV" | "NY" | "OH" | "OK" | "OR" | "PA" | "RI" | "SC" | "SD" | "TN" | "TX" | "UT" | "VA" | "VT" | "WA" | "WI" | "WV" | "WY") | No | US state codes. |
| `country` | string ("CA" | "US" | "UK") | Yes | Filter area codes by country. Required. Must be one of CA (Canada), US (United States), or UK (United Kingdom). |
| `province` | string ("AB" | "BC" | "MB" | "NB" | "NL" | "NT" | "NS" | "NU" | "ON" | "PE" | "QC" | "SK" | "YT") | No | Canadian province codes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Signature Request

**Slug:** `DROPBOX_SIGN_GET_SIGNATURE_REQUEST`

Retrieves the current status and complete details of a signature request by ID. Use this action to: - Check if signers have viewed, signed, or declined the request - Get signer information and signature timestamps - Access form field responses and custom field values - Retrieve URLs for document downloads and management - Monitor signature request progress and completion status Returns detailed information including signer names, emails, signing status, custom fields, response data, attachments, and signing options. Handles errors gracefully with structured error responses for invalid or non-existent signature request IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `signature_request_id` | string | Yes | Unique identifier of the signature request to retrieve (40-character hex string). Obtain this ID from the response when creating a signature request or from the list signature requests endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Signature Request Files as Data URI

**Slug:** `DROPBOX_SIGN_GET_SIGNATURE_REQUEST_FILES_AS_DATA_URI`

Tool to download signature request files as a base64-encoded data URI. Use when you need the document content as a data URI string for embedding or transmission. Returns immediately if files are ready (status 200), or indicates if files are still being prepared (status 409).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `signature_request_id` | string | Yes | The ID of the SignatureRequest to retrieve files for as data URI. This is a 40-character hex string obtained when creating a signature request or from the list signature requests endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Signature Request Files as File URL

**Slug:** `DROPBOX_SIGN_GET_SIGNATURE_REQUEST_FILES_AS_FILE_URL`

Retrieves a copy of the current documents and returns a JSON object with a URL to the file (PDFs only). Use this action when you need a temporary download link for signature request documents instead of downloading the files directly. The returned URL will expire after a certain time period indicated by the expires_at field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `signature_request_id` | string | Yes | The ID of the SignatureRequest to retrieve files for (40-character hex string). Obtain this ID from the response when creating a signature request or from the list signature requests endpoint. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Team Info

**Slug:** `DROPBOX_SIGN_GET_TEAM_INFO`

Retrieves information about a Dropbox Sign team, including team name, member count, and sub-team count. Use when you need to get team details. If team_id is provided, retrieves info for that specific team; otherwise retrieves info for the authenticated user's team.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `team_id` | string | No | The ID of the team to retrieve information for. Optional — if omitted, the API will return information for the authenticated user's team. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template

**Slug:** `DROPBOX_SIGN_GET_TEMPLATE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | The unique ID of the template to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Template Files

**Slug:** `DROPBOX_SIGN_GET_TEMPLATE_FILES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file_type` | string ("pdf" | "zip") | No | Format of the output: 'pdf' for merged PDF, 'zip' for individual docs in a ZIP archive. |
| `template_id` | string | Yes | ID of the HelloSign template to download documents for. Example: 3b2f1ac79dfc679ba07de7fa5f3c4e8a0c1b2d3e |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template Files as Data URI

**Slug:** `DROPBOX_SIGN_GET_TEMPLATE_FILES_AS_DATA_URI`

Tool to retrieve template documents as base64-encoded data URI. Use when you need template files in data URI format instead of downloading binary files.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | The id of the Template to get files for. Example: f57db65d3f933b5316d398057a36176831451a35 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Template Files as File URL

**Slug:** `DROPBOX_SIGN_GET_TEMPLATE_FILES_AS_FILE_URL`

Tool to retrieve a copy of template documents and return a JSON object with a URL to the file (PDFs only). Use this action when you need a temporary download link for template documents instead of downloading the files directly.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `template_id` | string | Yes | The ID of the template to retrieve files for. Obtain this ID from the response when creating a template or from the list templates endpoint. |
| `force_download` | integer | No | By default when opening the file_url a browser will download the PDF and save it locally. When set to 0 the PDF file will be displayed in the browser. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List API Apps

**Slug:** `DROPBOX_SIGN_LIST_API_APPS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return; minimum 1; default is 1. |
| `page_size` | integer | No | Number of API Apps per page; minimum 1; maximum 100; default is 20. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Bulk Send Jobs

**Slug:** `DROPBOX_SIGN_LIST_BULK_SEND_JOBS`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number of the Bulk Send Job list (default 1). |
| `page_size` | integer | No | Number of Bulk Send Jobs to return per page (1–100, default 20). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Faxes

**Slug:** `DROPBOX_SIGN_LIST_FAXES`

Tool to list faxes and their properties. Use when you need to retrieve paginated faxes with information about transmissions and status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return. Defaults to 1. |
| `page_size` | integer | No | Number of results per page (1–100). Defaults to 20. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fax Lines

**Slug:** `DROPBOX_SIGN_LIST_FAX_LINES`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return. Defaults to 1. |
| `page_size` | integer | No | Number of results per page (1–100). Defaults to 20. |
| `account_id` | string | No | Filter fax lines to this account ID. |
| `show_team_lines` | boolean | No | Include fax lines belonging to team members. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Signature Requests

**Slug:** `DROPBOX_SIGN_LIST_SIGNATURE_REQUESTS`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return. |
| `query` | string | No | Search string with optional fielded filters (e.g., 'from:me AND complete:true'). |
| `page_size` | integer | No | Number of objects per page, between 1 and 100. |
| `account_id` | string | No | Team account to list requests for; use 'all' for all team members; defaults to your account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Sub-Teams

**Slug:** `DROPBOX_SIGN_LIST_SUB_TEAMS`

Lists all sub-teams belonging to a parent team with pagination support. Returns team identifiers and names for each sub-team. Use this to discover the organizational structure of teams within Dropbox Sign. Requires a valid team_id from the parent team. Returns empty list if the team has no sub-teams or if team features are not available for the account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return; minimum is 1; default is 1. |
| `team_id` | string | Yes | The unique identifier of the parent team whose sub-teams you want to list. |
| `page_size` | integer | No | Number of items per page; range is 1 to 100; default is 20. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Team Members

**Slug:** `DROPBOX_SIGN_LIST_TEAM_MEMBERS`

Lists all members and their roles for a specific team. Returns a paginated list of team members with their account IDs, email addresses, and roles. Requires team_id which can be obtained from LIST_TEAMS or GET_TEAM_INFO actions. Supports pagination for teams with many members.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return (default is 1) |
| `team_id` | string | Yes | The ID of the team to retrieve members for |
| `page_size` | integer | No | Number of results per page (1-100, default is 20) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List All Teams

**Slug:** `DROPBOX_SIGN_LIST_TEAMS`

Lists all Dropbox Sign teams accessible to the authenticated user, including the current team and its sub-teams. Returns team IDs and names which can be used with other team-related actions. Returns an empty list if the account doesn't have team features enabled.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Templates

**Slug:** `DROPBOX_SIGN_LIST_TEMPLATES`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to return; minimum 1; default is 1 |
| `query` | string | No | Search string to filter templates; supports fielded queries per Search guide |
| `page_size` | integer | No | Number of templates per page; minimum 1; maximum 100; default is 20 |
| `account_id` | string | No | Team member account to return templates for; use 'all' for all members; defaults to your account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Generate OAuth Authorization URL

**Slug:** `DROPBOX_SIGN_O_AUTH_AUTHORIZE`

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

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `scope` | string | No | Optional space-delimited list of OAuth scopes. If omitted, default scopes for the app are used. |
| `state` | string | Yes | Opaque value used to maintain state between the request and callback. Must be unique per auth request. |
| `client_id` | string | No | Client ID of the Dropbox Sign API app. If not provided, the value from connection metadata will be used. |
| `redirect_uri` | string | No | Optional redirect URI to which the OAuth server will send the user after authorization. Must match a configured callback URL if provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Release Signature Request Hold

**Slug:** `DROPBOX_SIGN_RELEASE_SIGNATURE_REQUEST_HOLD`

Release a held signature request to send it to signers. Use this when a signature request was created from an unclaimed draft with hold_request=true and has been claimed but not yet sent. After releasing, the request will be sent to all designated signers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `signature_request_id` | string | Yes | ID of the held Signature Request to release. Must be exactly 40 characters long. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove User from Template

**Slug:** `DROPBOX_SIGN_REMOVE_USER_FROM_TEMPLATE`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account_id` | string | No | ID of the account to revoke access (must be 40 characters long). Takes precedence over email_address. |
| `template_id` | string | Yes | ID of the template from which to remove access. |
| `email_address` | string | No | Email of the account to revoke access. Ignored if account_id is provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Signature Request

**Slug:** `DROPBOX_SIGN_SEND_SIGNATURE_REQUEST`

Tool to create and send a new signature request with documents. Use when you need to send documents for electronic signature. The action sends emails to all specified signers with links to view and sign the documents. Supports multiple signers, CC recipients, custom fields, form fields, and various signing options. Documents can be uploaded directly or provided via publicly accessible URLs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Files to be signed. Either files or file_urls is required. |
| `title` | string | No | Internal title for the signature request (not shown to signers) |
| `message` | string | No | Custom message included in the signature request email to signers |
| `signers` | array | Yes | Array of signer objects. Each signer will receive an email to sign the document. |
| `subject` | string | No | Subject line for the signature request email sent to signers |
| `metadata` | object | No | Custom metadata key/value pairs (up to 10 pairs). Keys max 40 chars, values max 1000 chars. Included in webhook callbacks. |
| `file_urls` | array | No | URLs to remote documents to be signed (e.g., publicly accessible PDFs). Either files or file_urls is required. |
| `test_mode` | boolean | No | Create signature request in test mode (not legally binding, free). Use for testing integrations. |
| `allow_decline` | boolean | No | Allow signers to decline signing the document |
| `custom_fields` | array | No | Pre-filled merge fields for the signature request |
| `use_text_tags` | boolean | No | Enable text tag parsing in documents. Text tags are special formatted strings that define form fields. |
| `allow_reassign` | boolean | No | Allow signers to reassign the signature request to another person |
| `hide_text_tags` | boolean | No | Hide text tags from document after parsing. Only applies when use_text_tags is true. |
| `cc_email_addresses` | array | No | CC recipients who will receive a copy when the signature request is completed |
| `signing_redirect_url` | string | No | URL to redirect signers to after they complete signing |
| `form_fields_per_document` | array | No | Form field definitions for each document. Outer list corresponds to documents, inner list contains fields for that document. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Request Reminder

**Slug:** `DROPBOX_SIGN_SEND_SIGNATURE_REQUEST_REMINDER`

Sends an email reminder to a signer about a pending signature request. Use this when a signer needs a reminder to complete their signature. Important constraints: - Cannot send a reminder within 1 hour of the last reminder (automatic or manual) - Cannot be used with embedded signature requests - The signature request must exist and not be completed - The email address must match a signer on the request

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name of the signer. Required only when multiple signers on the request share the same email address, to disambiguate which signer to remind. |
| `email_address` | string | Yes | Email address of the signer who should receive the reminder. Must match an existing signer on the signature request. |
| `signature_request_id` | string | Yes | The unique ID of the signature request (40-character hexadecimal string). Get this from list or get signature request endpoints. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Dropbox Sign Account

**Slug:** `DROPBOX_SIGN_UPDATE_ACCOUNT`

Tool to update Dropbox Sign account properties and settings. Use when you need to modify callback URLs or locale settings for an account.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locale` | string | No | The locale used in the account (e.g., 'en_US', 'de_DE', 'fr_FR'). |
| `account_id` | string | No | The ID of the account to update (must be exactly 40 characters). |
| `callback_url` | string | No | The URL that Dropbox Sign should POST events to. Set to empty string to remove. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update API App

**Slug:** `DROPBOX_SIGN_UPDATE_API_APP`

Tool to update an existing API App in Dropbox Sign. Use when you need to modify API App settings such as name, callback URL, domains, OAuth configuration, branding options, or custom logo.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Name to assign to the API App |
| `oauth` | object | No | OAuth configuration for API App |
| `domains` | array | No | Domain names associated with the app |
| `options` | object | No | Options configuration for API App |
| `client_id` | string | Yes | The client ID of the API App to update |
| `callback_url` | string | No | URL where the API App receives event callbacks |
| `custom_logo_file` | object | No | An image file to use as a custom logo in embedded contexts. |
| `white_labeling_options` | object | No | White labeling customization options for API App |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Signature Request

**Slug:** `DROPBOX_SIGN_UPDATE_SIGNATURE_REQUEST`

Updates the email address and/or name for a specific signer on a signature request. Use this when you need to correct or update signer contact information before they complete signing. Important: This endpoint only works for signature requests created with explicit form_fields_per_document (no appended signature page). At least one of email_address or name must be provided.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | New name for the signer. Provide this and/or email_address to update. |
| `signature_id` | string | Yes | The signature ID for the signer whose information should be updated. Get this from the signatures list in the signature request object. |
| `email_address` | string | No | New email address for the signer. Must be a valid email format. Provide this and/or name to update. |
| `signature_request_id` | string | Yes | The unique ID of the signature request to update (40-character hexadecimal string). Get this from list or get signature request endpoints. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Template Files

**Slug:** `DROPBOX_SIGN_UPDATE_TEMPLATE_FILES`

Tool to update files for an existing template. Overlays new files with the overlay of an existing template. Use when you need to replace the documents in a template while keeping the field configuration. The update is processed asynchronously; completion is communicated via callback events (template_created or template_error).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `files` | array | No | Files to upload for the template. Use either files or file_urls, not both. |
| `message` | string | No | The new default template email message. |
| `subject` | string | No | The new default template email subject. |
| `client_id` | string | No | Client ID of the app you are using to update the template. |
| `file_urls` | array | No | URLs for files to use for the template. Dropbox Sign will download these files. Use either file_urls or files, not both. |
| `test_mode` | boolean | No | Whether this is a test. Signatures will not be legally binding if set to true. Defaults to false. |
| `template_id` | string | Yes | The ID of the template to update files for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Verify Dropbox Sign Account

**Slug:** `DROPBOX_SIGN_VERIFY_ACCOUNT`

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.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email_address` | string | Yes | Email address to verify for a Dropbox Sign account. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
