Merge branch 'master' into wari/ext-165-apaleo-api-support

NangoHQ · Oct 25, 2024 · f90fe52 · f90fe52
2 parents 3625222 + e0829e3
commit f90fe52
Show file tree

Hide file tree

Showing 83 changed files with 1,744 additions and 528 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,57 @@
 
 All notable changes to this project will be documented in this file.
 
+## [v0.42.19] - 2024-10-25
+
+### Added
+
+- *(integrations)* Platform changes to add JWT as an auth_mode (#2840) by @hassan254-prog
+- *(integration)* Add support for ghost APIs (#2841) by @hassan254-prog
+- *(integrations)* Add support for bill (#2852) by @hassan254-prog
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/1be625c44e798c684362708d6fe6b7d34fed122f by Andres Reales. Commit message: feat(freshdesk): add Freshdesk users integration (#63) by @github-actions[bot]
+- *(connection)* Add deleted_at to the upsert functions (#2864) by @hassan254-prog
+- Basic/apikey credentials check cron job (#2862) by @TBonnin
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/f9b5a6da1b1cb7a095d79f8c9bf62cee32199974 by Hassan_Wari. Commit message: feat(integrations): add bill integrations (#62) by @github-actions[bot]
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/7d7b6097fe5798bc3d64c4e6c0bb796e5a553c65 by Andres Reales. Commit message: feat(Intercom): add users syncs and actions to intercom integration (#64) by @github-actions[bot]
+- *(providers)* Add proxy fields to okta (#2867) by @hassan254-prog
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/620bbfd8754dc6b242f0d2d0e0e4cda7fcbfbd69 by Hassan_Wari. Commit message: feat(integrations): add okta integrations (#65) by @github-actions[bot]
+- *(ui)* Add missing script name, webhook secret update (#2865) by @bodinsamuel
+- *(integrations)* Add support for sedna (#2869) by @hassan254-prog
+- *(docs)* Add code snippet to ghost-admin (#2871) by @hassan254-prog
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/2b5aa3d6f42d91a6ad4f5b56dbdc7849ac3c764c by Hassan_Wari. Commit message: feat(integrations): add front integrations (#67) by @github-actions[bot]
+- *(integrations)* Add support for ragie.ai (#2876) by @Marfuen
+- *(webhooks)* [nan-1909] add in webhook support for airtable (#2875) by @khaliqgant
+- *(integrations)* Add support for malwarebytes (#2877) by @hassan254-prog
+- *(integrations)* Add support for datadog (#2879) by @hassan254-prog
+- *(notion-scim)* Support notion SCIM (#2880) by @khaliqgant
+- *(connections)* Add FK to end users (#2883) by @bodinsamuel
+- *(connections)* Link to end_user on success (#2884) by @bodinsamuel
+- *(malwarebytes)* Add malwarebytes required header (#2889) by @khaliqgant
+
+### Changed
+
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/6f59edcc16a7268cee5a5d7f2857f869c9e69a38 by Khaliq. Commit message: feat(intercom): [nan-1916] add fetch article action (#60) by @github-actions[bot]
+- RefreshTokens cron to use redis based locking  (#2859) by @TBonnin
+- Connect UI (#2863) by @bodinsamuel
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/5d31fe1ef6ef48f48e36cbe6351a9dabd7c6482e by Khaliq. Commit message: feat(airtable): [nan-1909] add airtable operations (#68) by @github-actions[bot]
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/ad5ab482e8d9386cc9058122f01b43298f2707fc by Khaliq. Commit message: feat(dropbox): Add Dropbox operations (#69) by @github-actions[bot]
+- Typo in node client (#2873) by @bodinsamuel
+- *(integration-templates)* Automated commit updating flows.yaml based on changes in https://github.com/NangoHQ/integration-templates/commit/a6f831c553f66b659b6334819e6817915c6c6bbd by Khaliq. Commit message: feat(hubspot): [nan-1888] [nan-1900] Hubspot products sync and create-property (#70) by @github-actions[bot]
+- Typo in nango.yaml (#2881) by @bodinsamuel
+
+### Fixed
+
+- *(response-saver)* Concat paginated responses (#2857) by @khaliqgant
+- *(connect-ui)* Skip integrations list when only one integration is allowed (#2837) by @bodinsamuel
+- *(bill.com)* Remove version to be able to put in the script (#2860) by @khaliqgant
+- Lock can be released even when not holding the lock (#2858) by @TBonnin
+- *(ui)* Allow to dismiss slack banner (#2866) by @bodinsamuel
+- *(connection)* GetConnectionCredentials should return credentials even on error (#2870) by @bodinsamuel
+- *(api)* Rename internal api connection->connections (#2872) by @bodinsamuel
+- *(ui)* Integration rename, env switch when showing one integration (#2878) by @bodinsamuel
+- *(dockerfile)* Do not clean up source (#2882) by @bodinsamuel
+- *(pagination)* [nan-1958] per page offset pagination (#2890) by @khaliqgant
+
 ## [v0.42.18] - 2024-10-18
 
 ### Added
@@ -2078,6 +2129,7 @@ All notable changes to this project will be documented in this file.
 - Update Zendesk Chat configuration file (#161) by @Frenchcooc
 - APIs using client_credentials as grant type (#165) by @Frenchcooc
 
+[v0.42.19]: https://github.com/NangoHQ/nango/compare/v0.42.18..v0.42.19
 [v0.42.18]: https://github.com/NangoHQ/nango/compare/v0.42.17..v0.42.18
 [v0.42.17]: https://github.com/NangoHQ/nango/compare/v0.42.15..v0.42.17
 [v0.42.15]: https://github.com/NangoHQ/nango/compare/v0.42.12..v0.42.15

diff --git a/Dockerfile b/Dockerfile
@@ -70,7 +70,7 @@ RUN true \
 # Clean src
 RUN true \
   && rm -rf packages/*/src \
-  && rm -rf packages/*/lib \
+  # && rm -rf packages/*/lib will break database migrations because they are not compiled; barely saves a few MBs
   && rm -rf packages/*/public \
   && rm -rf packages/*/node_modules
 

diff --git a/docs-v2/integrations/all/datadog.mdx b/docs-v2/integrations/all/datadog.mdx
@@ -0,0 +1,33 @@
+---
+title: Datadog
+sidebarTitle: Datadog
+---
+
+API configuration: [`datadog`](https://nango.dev/providers.yaml)
+
+## Features
+
+| Features | Status |
+| - | - |
+| [Auth (API Key)](/integrate/guides/authorize-an-api) | ✅ |
+| [Sync data](/integrate/guides/sync-data-from-an-api) | ✅ |
+| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) | ✅ |
+| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) | ✅ |
+| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |
+
+<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
+
+## Getting started
+
+-   [How to generate API and Application keys](https://docs.datadoghq.com/account_management/api-app-keys/#add-an-api-key-or-client-token)
+-   [Datadog Auth related docs](https://docs.datadoghq.com/api/latest/authentication/)
+-   [Datadog API docs](https://docs.datadoghq.com/api/latest/)
+-   [Datadog rate limiting](https://docs.datadoghq.com/api/latest/rate-limits/)
+
+<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
+
+## API gotchas
+
+- When creating a new connection in Nango, please add your specific `siteParameter`. To obtain this, kindly visit [Access the Datadog site](https://docs.datadoghq.com/getting_started/site/#access-the-datadog-site).
+
+<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/datadog.mdx)</Note>
diff --git a/docs-v2/integrations/all/dialpad.mdx b/docs-v2/integrations/all/dialpad.mdx
@@ -4,6 +4,7 @@ sidebarTitle: Dialpad
 ---
 
 API configuration: [`dialpad`](https://nango.dev/providers.yaml)
+API configuration: [`dialpad-sandbox`](https://nango.dev/providers.yaml)
 
 ## Features
 

diff --git a/docs-v2/integrations/all/ghost.mdx b/docs-v2/integrations/all/ghost.mdx
@@ -30,5 +30,26 @@ API configuration: [`ghost-admin`](https://nango.dev/providers.yaml), [`ghost-co
 
 - Both Admin and Content API keys can be be obtained by creating a new Custom Integration under the Integrations screen in Ghost Admin.
 - For Ghost Admin, the API Key should be in the format `id:secret`.
+- After creating a connection on Nango, you can use the token generated as follows;
+```js
+const connection = await nango.getConnection();
+
+const token = connection.credentials.token;
+
+if (!token) {
+    throw new nango.ActionError({
+        message: `Access token is missing`,
+    });
+}
+
+// Define the configuration for the API call
+const config: ProxyConfiguration = {
+    endpoint: '/users',
+    retries: 10,
+    headers: {
+        Authorization: `Ghost ${token}`,
+    },
+};
+```
 
 <Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/ghost.mdx)</Note>
diff --git a/docs-v2/integrations/all/malwarebytes.mdx b/docs-v2/integrations/all/malwarebytes.mdx
@@ -0,0 +1,32 @@
+---
+title: Malwarebytes
+sidebarTitle: Malwarebytes
+---
+
+API configurations: [`malwarebytes`](https://nango.dev/providers.yaml)
+
+## Features
+
+| Features | Status |
+| - | - |
+| [Auth (OAuth)](/integrate/guides/authorize-an-api) | ✅ |
+| [Sync data](/integrate/guides/sync-data-from-an-api) | ✅ |
+| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) | ✅ |
+| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) | ✅ |
+| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |
+
+<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
+
+## Getting started
+
+-   [OAuth related docs](https://developer.medallia.com/medallia-apis/reference/authentication)
+-   [Malwarebytes API docs](https://api.malwarebytes.com/nebula/v1/docs)
+-   [API rate Limiting](https://api.malwarebytes.com/nebula/v1/docs#section/Introduction/Rate-Limiting)
+
+<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
+
+## API gotchas
+-   To obtain a client ID/client secret pair, open the Nebula console, go to Settings -> APIs & Integrations. On that page, click the `Add` button and submit the form. Use the resulting client ID/client secret pair, when adding a new connection on Nango.
+-   Different authentication scopes are required for various operations within Malwarebytes. To understand the specific scope needed for each API request, please refer to the authentication section of the respective operation in the documentation.
+
+<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/malwarebytes.mdx)</Note>
diff --git a/docs-v2/integrations/all/notion.mdx b/docs-v2/integrations/all/notion.mdx
@@ -3,7 +3,7 @@ title: Notion
 sidebarTitle: Notion
 ---
 
-API configuration: [`notion`](https://nango.dev/providers.yaml)
+API configuration: [`notion`](https://nango.dev/providers.yaml), [`notion-scim`](https://nango.dev/providers.yaml)
 
 ## Features
 
@@ -30,5 +30,6 @@ API configuration: [`notion`](https://nango.dev/providers.yaml)
 - The Notion OAuth API doesn't support refreshing tokens, and so doesn't return a refresh token. The access token never expires.
 - Your Notion OAuth app will have the status "internal". You need to [make it "public"](https://developers.notion.com/docs/authorization#how-to-make-an-integration-public) to be able to initiate an OAuth flow. Only then, you will be able to get the OAuth client ID/secret and register your callback URL.
 - No OAuth scope is required by default.
+- Notion SCIM is an enterprise only API that uses an API token. See the Notion [docs](https://www.notion.so/help/provision-users-and-groups-with-scim) for more information
 
 <Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/notion.mdx)</Note>
diff --git a/docs-v2/integrations/all/ragieai.mdx b/docs-v2/integrations/all/ragieai.mdx
@@ -0,0 +1,31 @@
+---
+title: ragie.ai
+sidebarTitle: ragie.ai
+---
+
+API configuration: [`ragie.ai`](https://nango.dev/providers.yaml)
+
+## Features
+
+| Features | Status |
+| - | - |
+| [Auth (API Key)](/integrate/guides/authorize-an-api) | ✅ |
+| [Sync data](/integrate/guides/sync-data-from-an-api) | ✅ |
+| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) | ✅ |
+| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) | ✅ |
+| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |
+
+<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
+
+## Getting started
+
+-   [ragie.ai API docs](https://docs.ragie.ai/reference)
+-   [Authentication and API key](https://docs.ragie.ai/docs/getting-started#authentication)
+
+<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
+
+## API gotchas
+
+- ragie.ai uses API_KEY auth mode with `authorization: Bearer '{API_KEY}'` in the request header to access different endpoints.
+
+<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/ragieai.mdx)</Note>
diff --git a/docs-v2/integrations/all/sedna.mdx b/docs-v2/integrations/all/sedna.mdx
@@ -0,0 +1,33 @@
+---
+title: Sedna
+sidebarTitle: Sedna
+---
+
+API configurations: [`sedna`](https://nango.dev/providers.yaml), [`sedna-basic`](https://nango.dev/providers.yaml)
+
+## Features
+
+| Features | Status |
+| - | - |
+| [Auth (OAuth + Basic)](/integrate/guides/authorize-an-api) | ✅ |
+| [Sync data](/integrate/guides/sync-data-from-an-api) | ✅ |
+| [Perform workflows](/integrate/guides/perform-workflows-with-an-api) | ✅ |
+| [Proxy requests](/integrate/guides/proxy-requests-to-an-api) | ✅ |
+| [Receive webhooks](/integrate/guides/receive-webhooks-from-an-api) | 🚫 (time to contribute: &lt;48h) |
+
+<Tip>We can implement missing features in &lt;48h, just ask for it in the [community](https://nango.dev/slack).</Tip>
+
+## Getting started
+
+-   [OAuth-related docs](https://developers.sedna.com/reference/authentication-1#oauth-20)
+-   [Basic auth related doc](https://developers.sedna.com/reference/authentication-1#basic-auth)
+-   [Sedna API docs](https://developers.sedna.com/reference)
+
+<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>
+
+## API gotchas
+
+-   In order to use Basic Auth, simply use the `client_id` and `client_secret` from the API Credentials on the Sedna API Management settings page as the Basic Auth `username` and `password`, respectively.
+-   Sedna enforces a general rate limit of 100 requests, per second, per API key or IP address.
+
+<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/sedna.mdx)</Note>
diff --git a/docs-v2/integrations/analytics.mdx b/docs-v2/integrations/analytics.mdx
@@ -10,6 +10,7 @@ sidebarTitle: Analytics
 
 <CardGroup cols={4}>
     <Card title="Amplitude" href="/integrations/all/amplitude" color="#68a063" />
+    <Card title="Datadog" href="/integrations/all/datadog" color="#68a063" />
     <Card title="Fireflies" href="/integrations/all/fireflies" color="#68a063" />
     <Card title="Metabase" href="/integrations/all/metabase" color="#68a063" />
     <Card title="Mixpanel" href="/integrations/all/mixpanel" color="#68a063" />

diff --git a/docs-v2/integrations/communication.mdx b/docs-v2/integrations/communication.mdx
@@ -28,6 +28,7 @@ sidebarTitle: Communication
     <Card title="Podium" href="/integrations/all/podium" color="#68a063" />
     <Card title="Outlook" href="/integrations/all/outlook" color="#68a063" />
     <Card title="RingCentral" href="/integrations/all/ring-central" color="#68a063" />
+    <Card title="Sedna" href="/integrations/all/sedna" color="#68a063" />
     <Card title="Sendgrid" href="/integrations/all/sendgrid" color="#68a063" />
     <Card title="SharePoint Online" href="/integrations/all/sharepoint-online" color="#68a063" />
     <Card title="Slack" href="/integrations/all/slack" color="#68a063" />

diff --git a/docs-v2/integrations/dev-tools.mdx b/docs-v2/integrations/dev-tools.mdx
@@ -18,6 +18,7 @@ sidebarTitle: Developer Tools
     <Card title="Builder.io" href="/integrations/all/builder-io" color="#68a063" />
     <Card title="CodeClimate" href="/integrations/all/codeclimate" color="#68a063" />
     <Card title="Contentful" href="/integrations/all/contentful" color="#68a063" />
+    <Card title="Datadog" href="/integrations/all/datadog" color="#68a063" />
     <Card title="Digital Ocean" href="/integrations/all/digitalocean" color="#68a063" />
     <Card title="ElevenLabs" href="/integrations/all/elevenlabs" color="#68a063" />
     <Card title="fal.ai" href="/integrations/all/falai" color="#68a063" />
@@ -32,6 +33,7 @@ sidebarTitle: Developer Tools
     <Card title="Pendo" href="/integrations/all/pendo" color="#68a063" />
     <Card title="Perplexity" href="/integrations/all/perplexity" color="#68a063" />
     <Card title="Posthog" href="/integrations/all/posthog" color="#68a063" />
+    <Card title="Ragie AI" href="/integrations/all/ragieai" color="#68a063" />
     <Card title="RapidAPI" href="/integrations/all/rapidapi" color="#68a063" />
     <Card title="Replicate" href="/integrations/all/replicate" color="#68a063" />
     <Card title="Shortcut" href="/integrations/all/shortcut" color="#68a063" />

diff --git a/docs-v2/integrations/other.mdx b/docs-v2/integrations/other.mdx
@@ -29,6 +29,7 @@ sidebarTitle: Other
     <Card title="Osu!" href="/integrations/all/osu" color="#68a063" />
     <Card title="Ory" href="/integrations/all/ory" color="#68a063" />
     <Card title="Microsoft Entra ID" href="/integrations/all/microsoft-entra-id" color="#68a063" />
+    <Card title="Malwarebytes" href="/integrations/all/malwarebytes" color="#68a063" />
     <Card title="ServiceM8" href="/integrations/all/servicem8" color="#68a063" />
     <Card title="ServiceNow" href="/integrations/all/servicenow" color="#68a063" />
     <Card title="Splitwise" href="/integrations/all/splitwise" color="#68a063" />

diff --git a/docs-v2/mint.json b/docs-v2/mint.json
@@ -370,6 +370,7 @@
                 "integrations/all/coupa-compass",
                 "integrations/all/coros",
                 "integrations/all/datev",
+                "integrations/all/datadog",
                 "integrations/all/deel",
                 "integrations/all/dialpad",
                 "integrations/all/digitalocean",
@@ -453,6 +454,7 @@
                 "integrations/all/make",
                 "integrations/all/mailgun",
                 "integrations/all/manatal",
+                "integrations/all/malwarebytes",
                 "integrations/all/medallia",
                 "integrations/all/metabase",
                 "integrations/all/microsoft",
@@ -499,6 +501,7 @@
                 "integrations/all/quickbooks",
                 "integrations/all/ramp",
                 "integrations/all/reddit",
+                "integrations/all/ragieai",
                 "integrations/all/refiner",
                 "integrations/all/rapidapi",
                 "integrations/all/replicate",
@@ -507,6 +510,7 @@
                 "integrations/all/salesforce",
                 "integrations/all/salesforce-experience-cloud",
                 "integrations/all/salesloft",
+                "integrations/all/sedna",
                 "integrations/all/segment",
                 "integrations/all/sendgrid",
                 "integrations/all/servicem8",

diff --git a/docs-v2/reference/api-configuration.mdx b/docs-v2/reference/api-configuration.mdx
@@ -323,6 +323,9 @@ slack:
                 <ResponseField name="offset_name_in_request" type="string">
                     The name of the offset parameter in the request.
                 </ResponseField>
+                <ResponseField name="offset_calculation_method" type="string">
+                    The method to calculate the offset in the request. Must be one of: "per-page" or "by-response-size". Optional parameter that defaults to "by-response-size".
+                </ResponseField>
                 <ResponseField name="offset_start_value" type="number">
                     The starting value for the offset.
                 </ResponseField>

diff --git a/docs-v2/reference/integration-configuration.mdx b/docs-v2/reference/integration-configuration.mdx
@@ -153,7 +153,7 @@ Sync configuration fields are under `integrations.<INTEGRATION-ID>.syncs.<SYNC-N
     </Info>
 </ResponseField>
 
-<ResponseField name="webhook_subscriptions" type="string | string[]">
+<ResponseField name="webhook-subscriptions" type="string | string[]">
     Lists the types of external webhooks the sync script will handle. Multiple syncs can listen to the same subscription. Learn more about handling external webhooks in syncs: [step-by-step guide](/integrate/guides/receive-webhooks-from-an-api#handle-external-webhooks-in-syncs).
 </ResponseField>
-Original file line number
+Diff line change
@@ Expand Up / @@ -4,6 +4,7 @@ sidebarTitle: Dialpad @@
     ---
     API configuration: [`dialpad`](https://nango.dev/providers.yaml)
+    API configuration: [`dialpad-sandbox`](https://nango.dev/providers.yaml)
     ## Features
@@ Expand Down @@