diff --git a/docs-v2/integrations/all/asana-scim/connect.mdx b/docs-v2/integrations/all/asana-scim/connect.mdx index 19eddd07d4..1fc9f9ab05 100644 --- a/docs-v2/integrations/all/asana-scim/connect.mdx +++ b/docs-v2/integrations/all/asana-scim/connect.mdx @@ -6,7 +6,7 @@ sidebarTitle: Asana # Overview -To authenticate with Asana, you need two key pieces of information: +To authenticate with Asana, you need one piece of information: 1. **API Key** - Your Asana API Key diff --git a/docs-v2/integrations/all/copper-api-key/connect.mdx b/docs-v2/integrations/all/copper-api-key/connect.mdx new file mode 100644 index 0000000000..4354fb8fe5 --- /dev/null +++ b/docs-v2/integrations/all/copper-api-key/connect.mdx @@ -0,0 +1,37 @@ +--- +title: Copper - How do I link my account? +sidebarTitle: Copper +--- + + +# Overview + +To authenticate with Copper, you need one key piece of information: +1. **API Key** - Your Copper API Key + + +This guide will walk you through finding or creating those credentials within Copper. + + +### Prerequisites: + +- You must set up an account with Copper. + + +#### Step 1: Finding Copper API Key +1. Log into your Copper account and navigate to `System settings` > `Integrations` > `API Keys` and click the `GENERATE API KEY` button. + + + +2. After generating a new token, securely copy your API Key. Also note your email address related to the API key. + +#### Step 2: Connect Your Copper Account + + + +To authenticate using your API credentials, navigate to the Copper authentication form. +Enter your credentials as follows: +- API Key: Your API key +- User Email: Your email that created the API Key + +Click "Connect" to complete the authentication. diff --git a/docs-v2/integrations/all/copper-api-key/copper_key.png b/docs-v2/integrations/all/copper-api-key/copper_key.png new file mode 100644 index 0000000000..89cfcee327 Binary files /dev/null and b/docs-v2/integrations/all/copper-api-key/copper_key.png differ diff --git a/docs-v2/integrations/all/copper-api-key/nango_connect_ui.png b/docs-v2/integrations/all/copper-api-key/nango_connect_ui.png new file mode 100644 index 0000000000..cbda992c37 Binary files /dev/null and b/docs-v2/integrations/all/copper-api-key/nango_connect_ui.png differ diff --git a/docs-v2/integrations/all/copper.mdx b/docs-v2/integrations/all/copper.mdx new file mode 100644 index 0000000000..97e6649aaf --- /dev/null +++ b/docs-v2/integrations/all/copper.mdx @@ -0,0 +1,47 @@ +--- +title: Copper +sidebarTitle: Copper +--- + +API configuration: [`copper`](https://nango.dev/providers.yaml), [`copper-api-key`](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) | + +We can implement missing features in <48h, just ask for it in the [community](https://nango.dev/slack). + +## 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) + +Need help getting started? Get help in the [community](https://nango.dev/slack). + +## 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. + +- To generate an API token, in the Copper web app navigate to `System settings` > `Integrations` > `API Keys` and click the `GENERATE API KEY` button. + +Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/copper.mdx) + + + Guide to connect to Copper API Key using Nango Connect. + diff --git a/docs-v2/integrations/crm.mdx b/docs-v2/integrations/crm.mdx index fcb8d3100b..3b47cabd2b 100644 --- a/docs-v2/integrations/crm.mdx +++ b/docs-v2/integrations/crm.mdx @@ -31,15 +31,16 @@ Ask us in the [Slack community](https://nango.dev/slack) and we can help you qui + + - - + @@ -47,11 +48,11 @@ Ask us in the [Slack community](https://nango.dev/slack) and we can help you qui - + + - diff --git a/docs-v2/mint.json b/docs-v2/mint.json index 6398d582ee..1eb6f6c113 100644 --- a/docs-v2/mint.json +++ b/docs-v2/mint.json @@ -328,6 +328,7 @@ "integrations/all/contentstack", "integrations/all/coupa-compass", "integrations/all/coros", + "integrations/all/copper", "integrations/all/databricks", "integrations/all/datev", "integrations/all/datadog", diff --git a/packages/shared/providers.yaml b/packages/shared/providers.yaml index 23840e14f4..ca3ca4c7ea 100644 --- a/packages/shared/providers.yaml +++ b/packages/shared/providers.yaml @@ -1500,6 +1500,56 @@ 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/ + 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 + docs: https://docs.nango.dev/integrations/all/copper + +copper-api-key: + display_name: Copper (api key) + categories: + - crm + auth_mode: API_KEY + proxy: + base_url: https://api.copper.com/developer_api + headers: + X-PW-AccessToken: ${apiKey} + X-PW-Application: developer_api + X-PW-UserEmail: ${connectionConfig.userEmail} + Content-Type: application/json + verification: + method: GET + endpoint: /v1/account + docs_connect: https://docs.nango.dev/integrations/all/copper/connect + credentials: + apiKey: + type: string + title: API Key + description: The API key for your Copper account + pattern: '^[a-f0-9]{32}$' + example: '4f3c12efb9659a0b5c123b568745dbf9' + doc_section: '#step-1-finding-copper-api-key' + connection_config: + userEmail: + type: string + title: User Email + description: Email address of the user who generated the token + docs: https://docs.nango.dev/integrations/all/copper + connectwise-psa: display_name: ConnectWise PSA categories: @@ -2320,7 +2370,7 @@ firefish: display_name: Firefish scope_separator: ' ' categories: - - CRM + - crm auth_mode: OAUTH2_CC token_url: https://api.firefishsoftware.com/authorization/token token_params: diff --git a/packages/webapp/public/images/template-logos/copper-api-key.svg b/packages/webapp/public/images/template-logos/copper-api-key.svg new file mode 120000 index 0000000000..0543b5e1e5 --- /dev/null +++ b/packages/webapp/public/images/template-logos/copper-api-key.svg @@ -0,0 +1 @@ +copper.svg \ No newline at end of file diff --git a/packages/webapp/public/images/template-logos/copper.svg b/packages/webapp/public/images/template-logos/copper.svg new file mode 100644 index 0000000000..743d503730 --- /dev/null +++ b/packages/webapp/public/images/template-logos/copper.svg @@ -0,0 +1,13 @@ + + + + Copper-icon-pink + Created with Sketch. + + + + + + + + \ No newline at end of file