-
Notifications
You must be signed in to change notification settings - Fork 444
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
feat(integrations): Add copper integration #3071
Changes from 5 commits
df839ca
562bf2d
fc260b2
8a337cb
6f59571
f63362e
2b109d0
611931e
efbefcd
e33b2e8
55ed519
269d38c
378352c
ec3406b
ef39981
54b1eb3
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
--- | ||
title: Copper | ||
sidebarTitle: Copper | ||
--- | ||
|
||
API configuration: [`copper`](https://nango.dev/providers.yaml) | ||
|
||
|
||
## Features | ||
|
||
| Features | Status | | ||
| - | - | | ||
| [Auth (OAuth) + API Key](/guides/getting-started/authorize-an-api-from-your-app) | ✅ | | ||
| [Sync data](/guides/getting-started/read-from-an-api) | ✅ | | ||
| [Perform workflows](/guides/getting-started/write-to-an-api) | ✅ | | ||
| [Proxy requests](/guides/proxy-requests-to-an-api) | ✅ | | ||
| [Receive webhooks](/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: <48h) | | ||
|
||
<Tip>We can implement missing features in <48h, just ask for it in the [community](https://nango.dev/slack).</Tip> | ||
|
||
## Getting started | ||
|
||
- [Generate a copper API token in your copper developer account](https://support.copper.com/en/articles/8823347-generating-an-api-key) | ||
- [How to register your Oauth Application](https://developer.copper.com/introduction/oauth/index.html#2-prerequisites) | ||
- [OAuth related docs](https://developer.copper.com/introduction/oauth/quickstart.html) | ||
- [List of OAuth scopes](https://developer.copper.com/introduction/oauth/index.html#7-scopes) | ||
- [Copper API docs](https://developer.copper.com/introduction/requests.html#headers) | ||
- [API rate liming](https://developer.copper.com/introduction/requests.html#rate-limits) | ||
|
||
<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip> | ||
|
||
## API gotchas | ||
|
||
- Copper offers both OAuth and API_KEY authentication modes. To use OAuth2.0 with Copper, you must first register your application. | ||
To register your application, [contact](https://developer.copper.com/introduction/oauth/index.html#:~:text=To%20register%20your,all%20authorization%20flows.) copper. | ||
|
||
- You will need to provide the name and purpose of your application as well as a URL to an HTTPS endpoint that will handle the secure callback. | ||
You will receive two credentials, client_id and client_secret, required for all authorization flows. | ||
|
||
- The Dev API uses token based authentication. You have to include the token in the header of every request, along with the email address of the user who generated the token. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @dannylwe where in their documentation is this specified? Shouldn't we inject this for the user if this is the case? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. @khaliqgant Makes sense. This should be injected for the user |
||
|
||
<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/apollo.mdx)</Note> |
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -1489,6 +1489,25 @@ codeclimate: | |
title: API Key | ||
description: The API key for your Code Climate account | ||
|
||
copper: | ||
display_name: Copper | ||
categories: | ||
- crm | ||
auth_mode: OAUTH2 | ||
proxy: | ||
base_url: https://api.copper.com/developer_api/ | ||
docs: https://docs.nango.dev/integrations/all/copper | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. It might be helpful to include the docs link at the end. |
||
default_scopes: | ||
- developer/v1/all | ||
authorization_url: https://app.copper.com/oauth/authorize | ||
token_url: https://app.copper.com/oauth/token | ||
authorization_params: | ||
response_type: code | ||
token_params: | ||
grant_type: authorization_code | ||
refresh_params: | ||
grant_type: refresh_token | ||
|
||
connectwise-psa: | ||
display_name: ConnectWise PSA | ||
categories: | ||
|
@@ -2309,7 +2328,7 @@ firefish: | |
display_name: Firefish | ||
scope_separator: ' ' | ||
categories: | ||
- CRM | ||
- crm | ||
auth_mode: OAUTH2_CC | ||
token_url: https://api.firefishsoftware.com/authorization/token | ||
token_params: | ||
|
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.
Shouldn't we also add support for the API key auth as well?
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.
This has been added