> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dropbox Sign

## What's supported

### Supported actions

This connector supports:

* [Read Actions](/read-actions), including full historic backfill. Please note that incremental read is not supported, a full read of the Dropbox Sign instance will be done for each scheduled read.
* [Write Actions](/write-actions).
* [Proxy Actions](/proxy-actions), using the base URL `https://api.hellosign.com`.

### Supported objects

The Dropbox Sign connector supports reading from the following objects:

* [api\_app](https://developers.hellosign.com/api/reference/operation/apiAppList/)
* [bulk\_send\_job](https://developers.hellosign.com/api/reference/operation/bulkSendJobList/)
* [fax](https://developers.hellosign.com/api/reference/operation/faxList/)
* [fax\_line](https://developers.hellosign.com/api/reference/operation/faxLineList/)
* [signature](https://developers.hellosign.com/api/reference/operation/signatureRequestList/)
* [template](https://developers.hellosign.com/api/reference/operation/templateList/)

The Dropbox Sign connector supports writing to the following objects:

* [account](https://developers.hellosign.com/api/reference/operation/accountCreate/)
* [api\_app](https://developers.hellosign.com/api/reference/operation/apiAppCreate/)
* [draft](https://developers.hellosign.com/api/reference/operation/unclaimedDraftCreate/)
* [fax\_line](https://developers.hellosign.com/api/reference/operation/faxLineCreate/)
* [report](https://developers.hellosign.com/api/reference/operation/reportCreate/)
* [signature/embedded](https://developers.hellosign.com/api/reference/operation/signatureRequestCreateEmbedded/)
* [signature/embedded\_with\_template](https://developers.hellosign.com/api/reference/operation/signatureRequestCreateEmbeddedWithTemplate/)
* [team](https://developers.hellosign.com/api/reference/operation/teamCreate/)
* [template](https://developers.hellosign.com/api/reference/operation/templateCreate/)

### Example integration

For an example manifest file of a Dropbox Sign integration, visit our [samples repo on Github](https://github.com/amp-labs/samples/blob/main/dropbox-sign/amp.yaml).

## Before You Get Started

To integrate Dropbox Sign with Ampersand, you will need a [Dropbox Sign Account](https://sign.dropbox.com/).

Once your account is created, you'll need to create an app in Dropbox Sign, configure the Ampersand redirect URI within the app, and obtain the following credentials from your app:

* Client ID
* Oauth Secret

You will then use these credentials to connect your application to Ampersand.

### Create a Dropbox Account

Here's how you can sign up for a Dropbox account:

* Create an account from the [Dropbox Sign](https://sign.dropbox.com/) page.
* Sign up using your preferred method.

### Creating a Dropbox App

Follow the steps below to create a Dropbox app:

1. Log in to your [Dropbox Sign Account](https://app.hellosign.com/).
2. Go to **API**.
3. In the Click **Create app**.
4. Enter the following details in the **General Information** section:
   * **Name**: Enter a unique name for your app.
   * **Domain**: Enter the app domain.
5. In the **Oauth** section, select the **Enable OAuth for this app** checkbox.
6. In the **OAuth Callback** textbox, enter the **Ampersand** redirect URL: `https://api.withampersand.com/callbacks/v1/oauth`.
7. Select the applicable scopes.
8. Click **CREATE APPLICATION**.

<img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dropboxsign.gif?s=085738ae9601895fc7e2fd51eba2e344" alt="Alt text" width="1680" height="826" data-path="images/provider-guides/dropboxsign.gif" />

Once the app is created, you'll find the **Client ID** and **OAuth Secret** keys for your app in the app **Details** section of your app. Note these credentials as they are necessary for connecting your app to Ampersand.

## Add Your Dropbox Sign App Info to Ampersand

1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).

2. Select the project where you want to create a Dropbox integration.

   <img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dd47b7a-Ampersand.png?fit=max&auto=format&n=CkzFg-K1u4gYx3ZD&q=85&s=d580aa00cc421fe14cfbab79c2e0812f" alt="Alt text" width="2244" height="442" data-path="images/provider-guides/dd47b7a-Ampersand.png" />

3. Select **Provider apps**.

4. Select *Dropbox* from the **Provider** list.

5. Enter the previously obtained *App Key* in the **Client ID** field and the *App Secret* in the **Client Secret** field.

<img src="https://mintcdn.com/ampersand-24eb5c1a/CkzFg-K1u4gYx3ZD/images/provider-guides/dropboxsign-amp.gif?s=d73b65b83c75c7aea3e2efc7a751dafd" alt="Alt text" width="804" height="456" data-path="images/provider-guides/dropboxsign-amp.gif" />

6. Click **Save changes**.

## Using the connector

To start integrating with Dropbox Sign:

* Create a manifest file like the [example above](#example-integration).
* Deploy it using the [amp CLI](/cli/overview).
* If you are using Read Actions, create a [destination](/destinations).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component. The UI component will prompt the customer for OAuth authorization.
* Start using the connector!
  * If your integration has [Read Actions](/read-actions), you'll start getting webhook messages.
  * If your integration has [Write Actions](/write-actions), you can start making API calls to our Write API.
  * If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.