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
59 changes: 59 additions & 0 deletions docs-v2/integrations/all/dropbox-sign-oauth.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: Dropbox Sign (OAuth)
sidebarTitle: Dropbox Sign (OAuth)
---

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

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

## Access requirements
| Pre-Requisites | Status | Comment|
| - | - | - |
| Paid dev account | ✅ Required | Free developer account available |
| Paid test account | ✅ Required | Free test account available |
| Partnership | ❌ Not required | |
| App review | ✅ Required | Required for production use |
| Security audit | ❌ Not required | |

## Setup guide

_No setup guide yet._

<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-oauth.mdx)</Note>

## Useful links

- [OAuth Walkthrough](https://developers.hellosign.com/docs/oauth/walkthrough/)
- [OAuth Overview](https://developers.hellosign.com/docs/oauth/overview/)
- [App Approval Process](https://developers.hellosign.com/docs/oauth/app-approval/)
- [API Documentation](https://developers.hellosign.com/docs/api/overview/)

<Note>Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/dropbox-sign-oauth.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 test OAuth by authorizing your app from your own account while building.
- The OAuth flow supports two scenarios:
1. Authorization code flow - for users with existing Dropbox Sign accounts
2. Account creation flow - for new users to Dropbox Sign
- Access tokens are only valid for about an hour. You'll need to use the refresh token to generate new access tokens.
- When creating an app, you'll need to provide:
- App name
- OAuth callback URL
- Scopes (actions your app will be allowed to perform)

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

## Going further

<Card title="Connect to Dropbox Sign OAuth" icon="link" href="/integrations/all/dropbox-sign-oauth/connect" horizontal>
Guide to connect to Dropbox Sign OAuth using Connect UI
</Card>
51 changes: 51 additions & 0 deletions docs-v2/integrations/all/dropbox-sign-oauth/connect.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
title: Dropbox Sign OAuth - How do I link my account?
sidebarTitle: Dropbox Sign OAuth
---

# Overview

To authenticate with Dropbox Sign OAuth, you need:
1. **Client ID** - A unique identifier for your application.
2. **Client Secret** - A confidential key used to authenticate the identity of the application.

This guide will walk you through creating an app and obtaining these credentials within Dropbox Sign.

### Prerequisites:

- You must have a Dropbox Sign account.

### Instructions:

#### Step 1: Creating an App
1. Log in to your [Dropbox Sign Developer Portal](https://app.hellosign.com).
2. Click on the profile icon in the top right corner and select **Settings**.
3. Click on the **API** tab.
4. Scroll down and click on the **Create an App** button.
5. Enable **OAuth** and fill in the required information:
- **App Name**: Your application's name
- **OAuth Callback**: Add `https://api.nango.dev/oauth/callback` or your own callback URL from your Nango dashboard
- **Scopes**: Select the actions your app needs to perform
4. Click **Create App** to generate your credentials.

#### Step 2: Obtaining Credentials
1. After creating your app, you'll be provided with:
- **Client ID**
- **Client Secret**
2. Make a copy of these credentials, as they will be needed when configuring your integration in Nango. The **Client Secret** will not be shown again, so ensure you store it securely.

#### Step 3: App Approval
1. Before your app can be used in production, it needs to be approved by Dropbox Sign.
2. You can test your app by authorizing it from your own account while building.
3. When ready for production, follow the [App Approval Process](https://developers.hellosign.com/docs/app-approval/overview/).

#### Step 4: Enter credentials in the Connect UI

Once you have your **Client ID** and **Client Secret**:
1. Open the form where you need to authenticate with Dropbox Sign OAuth.
2. Enter the **Client ID** and **Client Secret** in their designated fields.
3. Submit the form, and you should be successfully authenticated.

<img src="/integrations/all/dropbox-sign-oauth/form.png" style={{maxWidth: "450px" }}/>

You are now connected to Dropbox Sign OAuth.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
42 changes: 42 additions & 0 deletions docs-v2/snippets/generated/dropbox-sign-oauth/PreBuiltTooling.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,42 @@
## 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 | ✅ |
| End-user authorization guide | ✅ |
| 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 | 🚫 (time to contribute: &lt;48h) |
| Per-customer configurations | ✅ |
</Accordion>
</AccordionGroup>
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>
19 changes: 19 additions & 0 deletions packages/providers/providers.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3098,6 +3098,25 @@ dropbox:
base_url: https://api.dropboxapi.com
docs: https://docs.nango.dev/integrations/all/dropbox

dropbox-sign-oauth:
display_name: Dropbox Sign (OAuth)
categories:
- legal
auth_mode: OAUTH2
authorization_url: https://app.hellosign.com/oauth/authorize
token_url: https://app.hellosign.com/oauth/token
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:
base_url: https://api.hellosign.com
docs: https://docs.nango.dev/integrations/all/dropbox-sign-oauth
docs_connect: https://docs.nango.dev/integrations/all/dropbox-sign-oauth/connect

drupal:
display_name: Drupal
categories:
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading