Skip to content

feat(integrations): Add support for Dropbox sign #4019

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
76 changes: 76 additions & 0 deletions docs-v2/integrations/all/dropbox-sign.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
---
title: Dropbox Sign
sidebarTitle: Dropbox Sign
---

import Overview from "/snippets/overview.mdx"
import PreBuiltTooling from "/snippets/generated/dropbox-sign/PreBuiltTooling.mdx"
import PreBuiltUseCases from "/snippets/generated/dropbox-sign/PreBuiltUseCases.mdx"

<Overview />
<PreBuiltTooling />
<PreBuiltUseCases />

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ✅ Not required | Free, self-signup for a [Dropbox Sign account](https://app.hellosign.com/account/signUp). |
| Paid test account | ✅ Not required | Free Dropbox Sign account can be used for testing. |
| Partnership | ✅ Not required | |
| App review | ✅ Not required | Required for production use |
| Security audit | ✅ Not required | |

## Setup guide

<Steps>
<Step title="Create a Dropbox Sign account">
If you don't already have one, sign up for a [Dropbox Sign account](https://app.hellosign.com/account/signUp).
</Step>
<Step title="Create a new API app">
1. Log in to your [Dropbox Sign account](https://app.hellosign.com/account/logIn)
2. Go to the [Create a new API app](https://app.hellosign.com/oauth/createAppForm) form.
3. Complete the **App Information** form with the following details:
- **Unique Name**: Enter a distinctive name for your API app (must be unique to your account and team).
- **Domain**: Specify the domain where embedded flows (like signing requests and templates) will be permitted (includes subdomains).
- **Event Callback**: Provide the endpoint URL for receiving signature request event notifications.
- **Signers can "Insert Everywhere"**(Optional): Enable to allow signers to complete all signature fields with one click.
- **Company Branding**(Optional): Upload a logo to customize the embedded signing experience.
- **Enable OAuth for this app**: Check this option to activate OAuth functionality.
- **OAuth callback**: Enter `https://api.nango.dev/oauth/callback`.
- **Oauth billing**: Select your preferred billing option.
- **Oauth Scopes**: Choose the appropriate scopes based on your selected billing option.
4. Click **CREATE APPLICATION** to submit the form.
5. When the confirmation popup appears, copy both the **Client ID** and **OAuth Secret**, you'll need these credentials when configuring your Nango integration.
</Step>
<Step title="Next">
Follow the [_Quickstart_](/getting-started/quickstart).
</Step>
</Steps>

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

<Note>Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/dropbox-sign.mdx)</Note>

## Useful links

| Topic | Links |
| - | - |
| General | [Website](https://www.dropboxsign.com/) |
| | [Sign up for a Dropbox Sign account](https://app.hellosign.com/account/signUp) |
| Developer | [API documentation](https://developers.hellosign.com/) |
| | [OAuth documentation](https://developers.hellosign.com/docs/oauth/overview/) |
| | [Authorization Code Flow](https://developers.hellosign.com/docs/oauth/walkthrough/#authorization-code-flow)
| | [List of Access scopes](https://developers.hellosign.com/docs/oauth/overview/#access-scopes) |
| | [Dropbox Sign application dashboard](https://app.hellosign.com/) |
| | [Creating a new API app](https://app.hellosign.com/oauth/createAppForm) |
| | [App Approval Process](https://developers.hellosign.com/docs/app-approval/overview/) |
| | [Rate limiting](https://developers.hellosign.com/#rate-limits) |


<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/dropbox-sign.mdx)</Note>

## API gotchas

- Dropbox Sign requires production approval for apps using OAuth. Your app cannot be authorized or added by other users until it is approved for production. You can however test OAuth by authorizing your app from your own account while building.

<Note>Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/dropbox-sign.mdx)</Note>
1 change: 1 addition & 0 deletions docs-v2/mint.json
Original file line number Diff line number Diff line change
Expand Up @@ -395,6 +395,7 @@
"integrations/all/docusign-sandbox",
"integrations/all/docuware",
"integrations/all/dropbox",
"integrations/all/dropbox-sign",
"integrations/all/drupal",
"integrations/all/e-conomic",
"integrations/all/ebay",
Expand Down
41 changes: 41 additions & 0 deletions docs-v2/snippets/generated/dropbox-sign/PreBuiltTooling.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
## Pre-built tooling
<AccordionGroup>
<Accordion title="✅ Authorization">
| Tools | Status |
| - | - |
| Pre-built authorization (OAuth) | ✅ |
| Credentials auto-refresh | ✅ |
| Auth parameters validation | ✅ |
| Pre-built authorization UI | ✅ |
| Custom authorization UI | ✅ |
| Expired credentials detection | ✅ |
</Accordion>
<Accordion title="✅ Read & write data">
| Tools | Status |
| - | - |
| Pre-built integrations | 🚫 (time to contribute: &lt;48h) |
| API unification | ✅ |
| 2-way sync | ✅ |
| Webhooks from Nango on data modifications | ✅ |
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: &lt;48h) |
| Proxy requests | ✅ |
</Accordion>
<Accordion title="✅ Observability & data quality">
| Tools | Status |
| - | - |
| HTTP request logging | ✅ |
| End-to-type type safety | ✅ |
| Data runtime validation | ✅ |
| OpenTelemetry export | ✅ |
| Slack alerts on errors | ✅ |
| Integration status API | ✅ |
</Accordion>
<Accordion title="✅ Customization">
| Tools | Status |
| - | - |
| Create or customize use-cases | ✅ |
| Pre-configured pagination | 🚫 (time to contribute: &lt;48h) |
| Pre-configured rate-limit handling | ✅ |
| Per-customer configurations | ✅ |
</Accordion>
</AccordionGroup>
5 changes: 5 additions & 0 deletions docs-v2/snippets/generated/dropbox-sign/PreBuiltUseCases.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
## Pre-built integrations

_No pre-built integration yet (time to contribute: &lt;48h)_

<Tip>Not seeing the integration you need? [Build your own](https://docs.nango.dev/guides/custom-integrations/overview) independently.</Tip>
21 changes: 21 additions & 0 deletions packages/providers/providers.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3164,6 +3164,27 @@ dropbox:
base_url: https://api.dropboxapi.com
docs: https://docs.nango.dev/integrations/all/dropbox

dropbox-sign:
display_name: Dropbox Sign
categories:
- legal
auth_mode: OAUTH2
authorization_url: https://app.hellosign.com/oauth/authorize
token_url: https://app.hellosign.com/oauth/token
authorization_url_skip_empty: true
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Tested the flow with this recently added flag and it works well.

authorization_params:
response_type: code
token_params:
grant_type: authorization_code
refresh_params:
grant_type: refresh_token
refresh_url: https://app.hellosign.com/oauth/token?refresh
proxy:
retry:
at: 'x-ratelimit-reset'
base_url: https://api.hellosign.com
docs: https://docs.nango.dev/integrations/all/dropbox-sign

drupal:
display_name: Drupal
categories:
Expand Down
6 changes: 6 additions & 0 deletions packages/webapp/public/images/template-logos/dropbox-sign.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading