-
Notifications
You must be signed in to change notification settings - Fork 488
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
lordsarcastic
wants to merge
9
commits into
master
Choose a base branch
from
ext-696
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
+150
−0
Open
Changes from all commits
Commits
Show all changes
9 commits
Select commit
Hold shift + click to select a range
566ed8c
feat(integrations): add Dropbox Sign OAuth integration and documentation
lordsarcastic 0d2b271
Chore: Renamed dropbox sign title
lordsarcastic a556783
Merge branch 'master' into ext-696
lordsarcastic 059507d
docs(dropbox-sign-oauth): update connection instructions and add visu…
lordsarcastic 939ebc3
Merge branch 'ext-696' of github.com:NangoHQ/nango into ext-696
lordsarcastic 89ffd37
Merge branch 'master' into ext-696
lordsarcastic e49ac2e
Merge branch 'master' into ext-696
hassan254-prog 817c96a
bring more additions
hassan254-prog 1eb6f86
Merge branch 'master' into ext-696
hassan254-prog File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
41 changes: 41 additions & 0 deletions
41
docs-v2/snippets/generated/dropbox-sign/PreBuiltTooling.mdx
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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: <48h) | | ||
| API unification | ✅ | | ||
| 2-way sync | ✅ | | ||
| Webhooks from Nango on data modifications | ✅ | | ||
| Real-time webhooks from 3rd-party API | 🚫 (time to contribute: <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: <48h) | | ||
| Pre-configured rate-limit handling | ✅ | | ||
| Per-customer configurations | ✅ | | ||
</Accordion> | ||
</AccordionGroup> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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: <48h)_ | ||
|
||
<Tip>Not seeing the integration you need? [Build your own](https://docs.nango.dev/guides/custom-integrations/overview) independently.</Tip> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
6 changes: 6 additions & 0 deletions
6
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.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
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.