# Dropbox Sign on boxd

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

- Page: https://boxd.sh/integrations/dropbox-sign/
- CLI: `run dropbox-sign` (56 commands, 11 marked common)
- SDK: `import { dropboxSign } from "@boxd/run"`; every parameter and response type is at `@boxd/run/dropbox-sign`
- Triggers: none
- Connect: `run auth dropbox-sign` (API key), or https://app.boxd.sh/integrations/detail/dropbox_sign
- All integrations: https://boxd.sh/integrations/ (Markdown: https://boxd.sh/integrations/index.md)

## From the shell

```sh
run auth dropbox-sign      # once: prints a link to connect your account
run dropbox-sign           # list its commands
run dropbox-sign get-template-files-as-data-uri --help
```

Parameters are flags (`--flag value`); object and array parameters take a JSON string. Output is YAML, or JSON with `--json`. Calls use your own connection; `--scope <name>` uses a connection shared with your team.

## From a script

```ts
import { every, dropboxSign } from "@boxd/run";

every("1 hour", async () => {
  const result = await dropboxSign.getTemplateFilesAsDataUri({ template_id: "…" });
  console.log(result);
});
```

Run it with `run dropbox-sign.run.ts`. Dropbox Sign has no triggers; `every()` polls on a schedule, keeps the script running as a job, and wakes the machine when it is due.

## Commands

Required flags are listed; `run dropbox-sign <command> --help` lists the optional ones. "common" marks what `run dropbox-sign` shows without `--all`.

| Command | SDK method | Required flags | Optional | Description |
|---|---|---|---|---|
| `add-user-to-team` | `dropboxSign.addUserToTeam()` | — | 4 | Invite a user to your Team |
| `add-user-to-template` | `dropboxSign.addUserToTemplate()` | `--template-id` | 3 | Grant a specified account access to a template |
| `bulk-create-embedded-sig-req-with-template` | `dropboxSign.bulkCreateEmbeddedSigReqWithTemplate()` | `--client-id` `--template-ids` | 11 | Create a BulkSendJob for embedded templated signature requests |
| `bulk-send-with-template` | `dropboxSign.bulkSendWithTemplate()` | `--template-ids` | 12 | Create a BulkSendJob for templated signature requests |
| `cancel-signature-request` ·common | `dropboxSign.cancelSignatureRequest()` | `--signature-request-id` | 0 | Cancels an incomplete signature request |
| `create-account` | `dropboxSign.createAccount()` | `--email-address` | 3 | Create a new Dropbox Sign account associated with a specified email address |
| `create-api-app` | `dropboxSign.createApiApp()` | `--domains` `--name` | 4 | Create a new Dropbox Sign API App |
| `create-embedded-signature-request` ·common | `dropboxSign.createEmbeddedSignatureRequest()` | `--client-id` `--signers` | 18 | Create an embedded signature request for signing in an iFrame |
| `create-embedded-signature-request-with-template` ·common | `dropboxSign.createEmbeddedSignatureRequestWithTemplate()` | `--client-id` `--signers` `--template-ids` | 12 | Create an embedded signature request based on a template |
| `create-embedded-template-draft` | `dropboxSign.createEmbeddedTemplateDraft()` | `--client-id` | 16 | Create an embedded template draft |
| `create-embedded-unclaimed-draft-with-template` | `dropboxSign.createEmbeddedUnclaimedDraftWithTemplate()` | `--client-id` `--requester-email-address` `--signers` `--template-ids` | 18 | Create an embedded unclaimed draft using saved templates |
| `create-report` | `dropboxSign.createReport()` | `--end-date` `--report-type` `--start-date` | 0 | Request creation of CSV report(s) for a specified date range |
| `create-template` ·common | `dropboxSign.createTemplate()` | `--form-fields-per-document` `--title` | 11 | Create a reusable template for document signing workflows |
| `create-unclaimed-draft` | `dropboxSign.createUnclaimedDraft()` | `--type` | 20 | Create an unclaimed draft that can be claimed via a unique URL |
| `delete-api-app` | `dropboxSign.deleteApiApp()` | `--client-id` | 0 | Delete an API App from your Dropbox Sign account by its client_id |
| `delete-fax` | `dropboxSign.deleteFax()` | `--fax-id` | 0 | Delete a fax from the system by its fax_id |
| `delete-template` | `dropboxSign.deleteTemplate()` | `--template-id` | 0 | Permanently deletes a template from your Dropbox Sign account by its template_id |
| `download-signature-request-files` | `dropboxSign.downloadSignatureRequestFiles()` | `--signature-request-id` | 1 | Download files for a signature request as PDF (merged) or ZIP (individual documents) |
| `edit-and-resend-embedded-signature-request` | `dropboxSign.editAndResendEmbeddedSignatureRequest()` | `--client-id` `--signature-request-id` | 20 | Edit and resend an embedded signature request |
| `edit-and-resend-signature-request` | `dropboxSign.editAndResendSignatureRequest()` | `--signature-request-id` | 25 | Edits and resends an existing non-templated signature request with updated documents, signers, or settings |
| `edit-and-resend-unclaimed-draft` | `dropboxSign.editAndResendUnclaimedDraft()` | `--client-id` `--signature-request-id` | 7 | Edit and resend a previously created unclaimed draft |
| `edit-resend-embedded-signature-request-template` | `dropboxSign.editResendEmbeddedSignatureRequestTemplate()` | `--client-id` `--signature-request-id` `--signers` `--template-ids` | 12 | Edit and resend an embedded signature request using templates |
| `get-account` | `dropboxSign.getAccount()` | — | 2 | Retrieves detailed information about a Dropbox Sign account including quotas, payment status, and settings |
| `get-api-app` | `dropboxSign.getApiApp()` | `--client-id` | 0 | Retrieve information about an API App by its client ID |
| `get-bulk-send-job` | `dropboxSign.getBulkSendJob()` | `--bulk-send-job-id` | 2 | Retrieve the status of a bulk send job |
| `get-current-team` | `dropboxSign.getCurrentTeam()` | — | 0 | Get the current team membership status and details |
| `get-embedded-sign-url` | `dropboxSign.getEmbeddedSignUrl()` | `--signature-id` | 0 | Retrieves an embedded signing URL for a specific signer's signature |
| `get-embedded-template-edit-url` | `dropboxSign.getEmbeddedTemplateEditUrl()` | `--template-id` | 10 | Generate an edit URL for embedded template editing |
| `get-fax-line-area-codes` | `dropboxSign.getFaxLineAreaCodes()` | `--country` | 3 | Retrieve available fax line area codes for a given country, state/province, and city |
| `get-signature-request` | `dropboxSign.getSignatureRequest()` | `--signature-request-id` | 0 | Retrieves the current status and complete details of a signature request by ID |
| `get-signature-request-files-as-data-uri` ·common | `dropboxSign.getSignatureRequestFilesAsDataUri()` | `--signature-request-id` | 0 | Download signature request files as a base64-encoded data URI |
| `get-signature-request-files-as-file-url` ·common | `dropboxSign.getSignatureRequestFilesAsFileUrl()` | `--signature-request-id` | 0 | Retrieves a copy of the current documents and returns a JSON object with a URL to the file (PDFs only) |
| `get-team-info` | `dropboxSign.getTeamInfo()` | — | 1 | Retrieves information about a Dropbox Sign team, including team name, member count, and sub-team count |
| `get-template` | `dropboxSign.getTemplate()` | `--template-id` | 0 | Return the specified template |
| `get-template-files` | `dropboxSign.getTemplateFiles()` | `--template-id` | 1 | Download documents associated with a template |
| `get-template-files-as-data-uri` ·common | `dropboxSign.getTemplateFilesAsDataUri()` | `--template-id` | 0 | Retrieve template documents as base64-encoded data URI |
| `get-template-files-as-file-url` ·common | `dropboxSign.getTemplateFilesAsFileUrl()` | `--template-id` | 1 | Retrieve a copy of template documents and return a JSON object with a URL to the file (PDFs only) |
| `list-api-apps` | `dropboxSign.listApiApps()` | — | 2 | List API Apps |
| `list-bulk-send-jobs` | `dropboxSign.listBulkSendJobs()` | — | 2 | List bulk send jobs |
| `list-fax-lines` | `dropboxSign.listFaxLines()` | — | 4 | List fax lines and their properties |
| `list-faxes` | `dropboxSign.listFaxes()` | — | 2 | List faxes and their properties |
| `list-signature-requests` | `dropboxSign.listSignatureRequests()` | — | 4 | List signature requests |
| `list-sub-teams` | `dropboxSign.listSubTeams()` | `--team-id` | 2 | Lists all sub-teams belonging to a parent team with pagination support |
| `list-team-members` | `dropboxSign.listTeamMembers()` | `--team-id` | 2 | Lists all members and their roles for a specific team |
| `list-teams` | `dropboxSign.listTeams()` | — | 0 | Lists all Dropbox Sign teams accessible to the authenticated user, including the current team and its sub-teams |
| `list-templates` | `dropboxSign.listTemplates()` | — | 4 | List templates |
| `o-auth-authorize` | `dropboxSign.oAuthAuthorize()` | `--state` | 3 | Generate an OAuth authorization URL |
| `release-signature-request-hold` | `dropboxSign.releaseSignatureRequestHold()` | `--signature-request-id` | 0 | Release a held signature request to send it to signers |
| `remove-user-from-template` | `dropboxSign.removeUserFromTemplate()` | `--template-id` | 2 | Remove an account's access to a template |
| `send-signature-request` ·common | `dropboxSign.sendSignatureRequest()` | `--signers` | 15 | Create and send a new signature request with documents |
| `send-signature-request-reminder` | `dropboxSign.sendSignatureRequestReminder()` | `--email-address` `--signature-request-id` | 1 | Sends an email reminder to a signer about a pending signature request |
| `update-account` | `dropboxSign.updateAccount()` | — | 3 | Update Dropbox Sign account properties and settings |
| `update-api-app` | `dropboxSign.updateApiApp()` | `--client-id` | 7 | Update an existing API App in Dropbox Sign |
| `update-signature-request` ·common | `dropboxSign.updateSignatureRequest()` | `--signature-id` `--signature-request-id` | 2 | Updates the email address and/or name for a specific signer on a signature request |
| `update-template-files` ·common | `dropboxSign.updateTemplateFiles()` | `--template-id` | 6 | Update files for an existing template |
| `verify-account` | `dropboxSign.verifyAccount()` | `--email-address` | 0 | Verify whether a Dropbox Sign account exists for the given email |

## Docs

- [run CLI](https://docs.boxd.sh/cli/run): Call connected integrations from the shell, connect new ones, and run automations.
- [Quickstart](https://docs.boxd.sh/guides/integrations/quickstart): Connect an integration, call it from the shell, and turn a script into an automation.
- [Connections](https://docs.boxd.sh/guides/integrations/connections): Connect an account once, for yourself or for your whole organization.
- [Scripts](https://docs.boxd.sh/guides/automations/scripts): Typed integrations, triggers, schedules and state in a .run.ts file.
- [Jobs](https://docs.boxd.sh/guides/automations/jobs): How a script becomes a background job: states, retries, sleep and wake.
- [Beyond the catalog](https://docs.boxd.sh/guides/automations/beyond-the-catalog): Reach your own APIs, databases and cloud accounts from a script.