diff --git a/docs/api-catalog.txt b/docs/api-catalog.txt index 05e855c873..c3e7078343 100644 --- a/docs/api-catalog.txt +++ b/docs/api-catalog.txt @@ -2,7 +2,7 @@ > Compact provider slug catalog for agents. Use the slug to reconstruct provider-specific docs URLs only when needed. -Provider count: 879 +Provider count: 881 URL patterns: - Main provider page: https://nango.dev/docs/integrations/all/{slug}.md or https://nango.dev/docs/api-integrations/{slug}.md @@ -481,6 +481,8 @@ URL patterns: | `microsoft-admin` | Microsoft (Admin) | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-admin.md) | [connect](https://nango.dev/docs/integrations/all/microsoft-admin/connect.md) | | communication, dev-tools, productivity, iam | | `microsoft-ads` | Microsoft Ads | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-ads.md) | | [setup](https://nango.dev/docs/api-integrations/microsoft/how-to-register-your-own-microsoft-api-oauth-app.md) | marketing | | `microsoft-business-central` | Microsoft Business Central | OAUTH2_CC | [docs](https://nango.dev/docs/integrations/all/microsoft-business-central.md) | [connect](https://nango.dev/docs/integrations/all/microsoft-business-central/connect.md) | | erp | +| `microsoft-dynamics-365-finance-and-operations` | Microsoft Dynamics 365 Finance and Operations | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations.md) | [connect](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/connect.md) | [setup](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/how-to-register-your-own-microsoft-dynamics-365-finance-and-operations-api-oauth-app.md) | erp | +| `microsoft-dynamics-365-finance-and-operations-cc` | Microsoft Dynamics 365 Finance and Operations (Client Credentials) | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc.md) | [connect](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect.md) | | erp | | `microsoft-entra-id` | Microsoft Entra ID | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-entra-id.md) | | [setup](https://nango.dev/docs/api-integrations/microsoft/how-to-register-your-own-microsoft-api-oauth-app.md) | iam | | `microsoft-excel` | Microsoft Excel | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-excel.md) | | [setup](https://nango.dev/docs/api-integrations/microsoft/how-to-register-your-own-microsoft-api-oauth-app.md) | productivity, analytics | | `microsoft-intune` | Microsoft Intune | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/microsoft-intune.md) | [connect](https://nango.dev/docs/api-integrations/microsoft-intune/connect.md) | | dev-tools | diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc.mdx b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc.mdx new file mode 100644 index 0000000000..1dff320371 --- /dev/null +++ b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc.mdx @@ -0,0 +1,86 @@ +--- +title: 'Microsoft Dynamics 365 Finance and Operations (Client Credentials)' +sidebarTitle: 'Microsoft Dynamics 365 F&O (Client Credentials)' +description: 'Integrate your application with the Microsoft Dynamics 365 Finance and Operations API using Client Credentials' +--- + +## 🚀 Quickstart + +Connect to Microsoft Dynamics 365 Finance and Operations (Client Credentials) with Nango and see data flow in 2 minutes. + + + + In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> _Configure New Integration_ -> _Microsoft Dynamics 365 Finance and Operations (Client Credentials)_. + + + Go to [Connections](https://app.nango.dev/dev/connections) -> _Add Test Connection_ -> _Authorize_, then enter your **Tenant ID**, **Environment URL**, **Client ID**, and **Client Secret**. Later, you'll let your users do the same directly from your app. + + + Let's make your first request to the Microsoft Dynamics 365 Finance and Operations OData API (list the data entities available in the environment). Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections): + + + + ```bash + curl "https://api.nango.dev/proxy/data" \ + -H "Authorization: Bearer " \ + -H "Provider-Config-Key: " \ + -H "Connection-Id: " + ``` + + + + + + Install Nango's backend SDK with `npm i @nangohq/node`. Then run: + + ```typescript + import { Nango } from '@nangohq/node'; + + const nango = new Nango({ secretKey: '' }); + + const res = await nango.get({ + endpoint: '/data', + providerConfigKey: '', + connectionId: '' + }); + + console.log(res.data); + ``` + + + + + Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/api/connection/get). + + ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests. + + + + Follow our [Auth implementation guide](/guides/primitives/auth) to integrate Nango in your app. + + To obtain your own production credentials, follow the [connect guide](/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect) linked below. + + + +## 📚 Microsoft Dynamics 365 Finance and Operations (Client Credentials) Integration Guides + +Nango maintained guides for common use cases. + +- [How do I link my account?](/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect) +Find your Tenant ID, Environment URL, Client ID, and Client Secret to connect Microsoft Dynamics 365 Finance and Operations + +Official docs: [Service endpoints overview](https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/data-entities/services-home-page) + +## 🧩 Pre-built syncs & actions for Microsoft Dynamics 365 Finance and Operations (Client Credentials) + +Enable them in your dashboard. Extend and customize to fit your needs. + +import PreBuiltUseCases from "/snippets/generated/microsoft-dynamics-365-finance-and-operations-cc/PreBuiltUseCases.mdx" + + + +## API gotchas + +- You don't need to set a `scope` yourself — Nango generates it from the **Environment URL** you provide when connecting, and uses that same URL as the API base URL. + +--- diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect.mdx b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect.mdx new file mode 100644 index 0000000000..f0d29541fe --- /dev/null +++ b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect.mdx @@ -0,0 +1,78 @@ +--- +title: 'Microsoft Dynamics 365 Finance and Operations (Client Credentials) - How do I link my account?' +sidebarTitle: 'Microsoft Dynamics 365 F&O (Client Credentials) Connect' +--- + +# Overview + +To connect Microsoft Dynamics 365 Finance and Operations (Client Credentials) in Nango, you need to provide: + +1. **Tenant ID** — The unique identifier for your organization that uses Microsoft services. +2. **Environment URL** — The domain of your Finance and Operations environment. +3. **Client ID** — The unique identifier that Azure assigns to your application when it's registered. +4. **Client Secret** — A unique string that enables the application to access Microsoft Dynamics 365 Finance and Operations without a signed-in user. + +This guide will walk you through generating and finding these credentials within Azure. + +### Prerequisites + +- You must have an active Microsoft Entra ID (Azure AD) account with access to a Finance and Operations environment, and permission to grant admin consent for application permissions. + +### Step 1: Finding your Tenant ID + +1. Your Tenant ID can be found in the **Tenant ID** field on the [Overview page](https://aad.portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview) within your Azure account. + + +### Step 2: Finding your Environment URL + +Sign in to your Finance and Operations environment, then copy its domain from the browser's address bar — everything after `https://` and before the first `/` (for example, `mycompany.operations.dynamics.com`). + +### Step 3: Generating your Client ID + +1. Navigate to the [Azure portal home page](https://portal.azure.com/#home) and sign in using the credentials of an administrator. +2. Select **App registrations**. + +3. Select **New registration**. + +4. In the **Register an application** section, enter a meaningful application name to display to users. Select who can use this application based on your environment and click **Register**. + +5. Once you have registered your application, your **Client ID** will be displayed in the **Application (client) ID** field within the **Essentials**. + + +### Step 4: Generating your Client Secret + +1. After registering a new app in the [step above](#step-3-generating-your-client-id), navigate to **Certificates & secrets** under **Manage**, and click **New client secret**. +2. A pop-up modal will appear, prompting you to enter your secret's **Description** and **Expires** values. Fill these then click on **Add**. + +3. Once completed, your **Client Secret** will be generated. This value can be found in the **Value** field within the **Client Secrets** table. + +4. After generating the **Client Secret**, you must grant the registered application the necessary permissions. Navigate to **API permissions**, select **Add a permission**, select **APIs my organization uses**, and search for **Microsoft Dynamics ERP** (app ID URI `Microsoft.ERP`). +5. From the displayed list, choose **Application permissions** (not Delegated permissions — there is no signed-in user in this flow), select the required permissions, click **Add permissions**, then select **Grant admin consent for [tenant]**. + + +### Step 5: Registering the application inside Finance and Operations + +1. Sign in to your Finance and Operations environment as an administrator. +2. In the search bar, search for **Microsoft Entra ID applications** and open it. + + + + +3. Select **New**, then enter the **Client ID** from the step above and set **User ID** to `Admin`. + + + +4. Save the record, then select it and enable it. + +### Step 6: Enter credentials in the Connect UI + +Once you have your credentials: + +1. Open the form where you need to authenticate with Microsoft Dynamics 365 Finance and Operations (Client Credentials). +2. Enter the **Tenant ID**, **Environment URL**, **Client ID**, and **Client Secret** in their designated fields. +3. Submit the form, and you should be successfully authenticated. + + + + +You are now connected to Microsoft Dynamics 365 Finance and Operations (Client Credentials). diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/dashboard.png b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/dashboard.png new file mode 100644 index 0000000000..3bcfb0069e Binary files /dev/null and b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/dashboard.png differ diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/form.png b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/form.png new file mode 100644 index 0000000000..15db46a1c0 Binary files /dev/null and b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/form.png differ diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/permissions.png b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/permissions.png new file mode 100644 index 0000000000..ee11a75254 Binary files /dev/null and b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/permissions.png differ diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/setting_client.png b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/setting_client.png new file mode 100644 index 0000000000..cb56216754 Binary files /dev/null and b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/setting_client.png differ diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations.mdx b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations.mdx new file mode 100644 index 0000000000..b1507eaad4 --- /dev/null +++ b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations.mdx @@ -0,0 +1,85 @@ +--- +title: 'Microsoft Dynamics 365 Finance and Operations' +sidebarTitle: 'Microsoft Dynamics 365 Finance and Operations' +description: 'Integrate your application with the Microsoft Dynamics 365 Finance and Operations API' +--- + +## 🚀 Quickstart + +Connect to Microsoft Dynamics 365 Finance and Operations with Nango and see data flow in 2 minutes. + + + + In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> _Configure New Integration_ -> _Microsoft Dynamics 365 Finance and Operations_. + + + Go to [Connections](https://app.nango.dev/dev/connections) -> _Add Test Connection_ -> _Authorize_, then enter your **Tenant ID** and **Environment URL**, and log in to Microsoft Dynamics 365 Finance and Operations. Later, you'll let your users do the same directly from your app. + + + Let's make your first request to the Microsoft Dynamics 365 Finance and Operations OData API (list the data entities available in the environment). Replace the placeholders below with your [secret key](https://app.nango.dev/dev/environment-settings), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections): + + + + ```bash + curl "https://api.nango.dev/proxy/data" \ + -H "Authorization: Bearer " \ + -H "Provider-Config-Key: " \ + -H "Connection-Id: " + ``` + + + + + + Install Nango's backend SDK with `npm i @nangohq/node`. Then run: + + ```typescript + import { Nango } from '@nangohq/node'; + + const nango = new Nango({ secretKey: '' }); + + const res = await nango.get({ + endpoint: '/data', + providerConfigKey: '', + connectionId: '' + }); + + console.log(res.data); + ``` + + + + + Or fetch credentials with the [Node SDK](/reference/sdks/node#get-a-connection-with-credentials) or [API](/reference/api/connection/get). + + ✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests. + + + + Follow our [Auth implementation guide](/guides/primitives/auth) to integrate Nango in your app. + + To obtain your own production credentials, follow the setup guide linked below. + + + +## 📚 Microsoft Dynamics 365 Finance and Operations Integration Guides + +Nango maintained guides for common use cases. + +- [How to register your own Microsoft Dynamics 365 Finance and Operations API OAuth app](/api-integrations/microsoft-dynamics-365-finance-and-operations/how-to-register-your-own-microsoft-dynamics-365-finance-and-operations-api-oauth-app) +Register an OAuth app with Microsoft Entra ID and obtain credentials to connect Microsoft Dynamics 365 Finance and Operations to Nango + +- [How do I link my account?](/api-integrations/microsoft-dynamics-365-finance-and-operations/connect) +Find your Tenant ID and Environment URL to connect Microsoft Dynamics 365 Finance and Operations + +Official docs: [Service endpoints overview](https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/data-entities/services-home-page) + +## 🧩 Pre-built syncs & actions for Microsoft Dynamics 365 Finance and Operations + +Enable them in your dashboard. Extend and customize to fit your needs. + +import PreBuiltUseCases from "/snippets/generated/microsoft-dynamics-365-finance-and-operations/PreBuiltUseCases.mdx" + + + +--- diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/connect.mdx b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/connect.mdx new file mode 100644 index 0000000000..ae35b34ceb --- /dev/null +++ b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/connect.mdx @@ -0,0 +1,38 @@ +--- +title: 'Microsoft Dynamics 365 Finance and Operations - How do I link my account?' +sidebarTitle: 'Microsoft Dynamics 365 Finance and Operations Connect' +--- + +# Overview + +To connect Microsoft Dynamics 365 Finance and Operations in Nango, you need to provide: + +1. **Tenant ID** — The unique identifier for your organization that uses Microsoft services. +2. **Environment URL** — The domain of your Finance and Operations environment. + +This guide walks you through finding both values, then authorizing through Microsoft Entra ID. + +### Prerequisites + +- You must have an active Microsoft Entra ID (Azure AD) account with access to a Finance and Operations environment. + +### Step 1: Finding your Tenant ID + +1. Your Tenant ID can be found in the **Tenant ID** field on the [Overview page](https://aad.portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview) within your Azure account. + + +### Step 2: Finding your Environment URL + +Sign in to your Finance and Operations environment, then copy its domain from the browser's address bar — everything after `https://` and before the first `/` (for example, `mycompany.operations.dynamics.com`). + +### Step 3: Authorize the connection + +1. Open the form where you need to authenticate with Microsoft Dynamics 365 Finance and Operations. +2. Enter the **Tenant ID** and **Environment URL** in their designated fields. +3. Submit the form, then log in with your Microsoft account and grant the requested permissions. + + + + + +You are now connected to Microsoft Dynamics 365 Finance and Operations. diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/form.png b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/form.png new file mode 100644 index 0000000000..d1744ea827 Binary files /dev/null and b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/form.png differ diff --git a/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/how-to-register-your-own-microsoft-dynamics-365-finance-and-operations-api-oauth-app.mdx b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/how-to-register-your-own-microsoft-dynamics-365-finance-and-operations-api-oauth-app.mdx new file mode 100644 index 0000000000..bf1b04ff9f --- /dev/null +++ b/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/how-to-register-your-own-microsoft-dynamics-365-finance-and-operations-api-oauth-app.mdx @@ -0,0 +1,48 @@ +--- +title: 'How to register your own Microsoft Dynamics 365 Finance and Operations OAuth app' +sidebarTitle: 'Microsoft Dynamics 365 F&O Setup' +description: 'Register an OAuth app with Microsoft Entra ID and connect it to Nango' +--- + +This guide shows you how to register your own app with Microsoft Entra ID to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Microsoft Dynamics 365 Finance and Operations environment. + + + + If you don't already have them, sign up for a [Microsoft account](https://account.microsoft.com/account) and an [Azure account](https://azure.microsoft.com/free). + + + 1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com) as at least an Application Developer. + 2. If you have access to multiple tenants, use the Settings icon in the top menu to switch to the tenant that hosts your Finance and Operations environment. + 3. From the search bar, search for **App registrations** and select it, then choose **New registration**. + 4. Enter a meaningful name for your application, for example "Nango Integration", and click **Register**. + + + After registration, you'll be taken to the application's Overview page. Record the **Application (client) ID**. + + + 1. In the left sidebar, select **Authentication**. + 2. Under **Platform configurations**, select **Add a platform**, then select **Web**. + 3. Enter `https://api.nango.dev/oauth/callback` as the Redirect URI, then click **Configure**. + + + 1. In the left sidebar, select **API permissions**, then click **Add a permission**. + 2. Select **APIs my organization uses**, and search for **Dynamics ERP**. If it doesn't show up in the picker, search for the full name exactly as written above. + 3. Under **Delegated permissions**, select the permissions you require. + 4. Click **Add permissions**, then click **Grant admin consent** if you have permission to do so. + + + 1. In the left sidebar, select **Certificates & secrets**. + 2. Under **Client secrets**, click **New client secret**. + 3. Enter a description and an expiration period, then click **Add**. + 4. **Important**: Copy the secret value immediately — you won't be able to see it again after you leave this page. + + + Follow the [_Quickstart_](/getting-started/quickstart). + + + +## API gotchas + +For more details, see [Development and administration for finance and operations apps - Service endpoints overview](https://learn.microsoft.com/en-us/dynamics365/fin-ops-core/dev-itpro/data-entities/services-home-page#authentication). + +--- diff --git a/docs/docs.json b/docs/docs.json index 6ce3a9cf6a..7225804c7d 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -1378,6 +1378,8 @@ "api-integrations/microsoft", "integrations/all/microsoft-ads", "integrations/all/microsoft-business-central", + "api-integrations/microsoft-dynamics-365-finance-and-operations", + "api-integrations/microsoft-dynamics-365-finance-and-operations-cc", "integrations/all/microsoft-entra-id", "integrations/all/microsoft-excel", "api-integrations/microsoft-planner", diff --git a/docs/llms-full.txt b/docs/llms-full.txt index e2f1622ed0..ff2950b0ac 100644 --- a/docs/llms-full.txt +++ b/docs/llms-full.txt @@ -14774,6 +14774,8 @@ Use these slugs to construct provider-specific docs URLs only when needed. | `microsoft-admin` | Microsoft (Admin) | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-admin.md) | [connect](https://nango.dev/docs/integrations/all/microsoft-admin/connect.md) | | communication, dev-tools, productivity, iam | | `microsoft-ads` | Microsoft Ads | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-ads.md) | | [setup](https://nango.dev/docs/api-integrations/microsoft/how-to-register-your-own-microsoft-api-oauth-app.md) | marketing | | `microsoft-business-central` | Microsoft Business Central | OAUTH2_CC | [docs](https://nango.dev/docs/integrations/all/microsoft-business-central.md) | [connect](https://nango.dev/docs/integrations/all/microsoft-business-central/connect.md) | | erp | +| `microsoft-dynamics-365-finance-and-operations` | Microsoft Dynamics 365 Finance and Operations | OAUTH2 | [docs](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations.md) | [connect](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/connect.md) | [setup](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/how-to-register-your-own-microsoft-dynamics-365-finance-and-operations-api-oauth-app.md) | erp | +| `microsoft-dynamics-365-finance-and-operations-cc` | Microsoft Dynamics 365 Finance and Operations (Client Credentials) | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc.md) | [connect](https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect.md) | | erp | | `microsoft-entra-id` | Microsoft Entra ID | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-entra-id.md) | | [setup](https://nango.dev/docs/api-integrations/microsoft/how-to-register-your-own-microsoft-api-oauth-app.md) | iam | | `microsoft-excel` | Microsoft Excel | OAUTH2 | [docs](https://nango.dev/docs/integrations/all/microsoft-excel.md) | | [setup](https://nango.dev/docs/api-integrations/microsoft/how-to-register-your-own-microsoft-api-oauth-app.md) | productivity, analytics | | `microsoft-intune` | Microsoft Intune | OAUTH2_CC | [docs](https://nango.dev/docs/api-integrations/microsoft-intune.md) | [connect](https://nango.dev/docs/api-integrations/microsoft-intune/connect.md) | | dev-tools | diff --git a/docs/llms.txt b/docs/llms.txt index 7a573871a7..9a2e6a3aea 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -139,7 +139,7 @@ Use provider URLs by replacing `{slug}` with a slug from the API catalog: ## APIs and integrations -- [API catalog](https://nango.dev/docs/api-catalog.txt): 879 provider slugs with canonical docs routes, auth modes, setup guides, and connect guides. +- [API catalog](https://nango.dev/docs/api-catalog.txt): 881 provider slugs with canonical docs routes, auth modes, setup guides, and connect guides. - Provider-specific pages are intentionally not expanded here so core Nango guides remain easy for agents to find. ## Resources diff --git a/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations-cc/PreBuiltTooling.mdx b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations-cc/PreBuiltTooling.mdx new file mode 100644 index 0000000000..434860d66b --- /dev/null +++ b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations-cc/PreBuiltTooling.mdx @@ -0,0 +1,41 @@ +## Pre-built tooling + + +| Tools | Status | +| - | - | +| Pre-built authorization (OAuth) | ✅ | +| Credentials auto-refresh | ✅ | +| Pre-built authorization UI | ✅ | +| Custom authorization UI | ✅ | +| End-user authorization guide | ✅ | +| Expired credentials detection | ✅ | + + +| 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 | ✅ | + + +| Tools | Status | +| - | - | +| HTTP request logging | ✅ | +| End-to-end type safety | ✅ | +| Data runtime validation | ✅ | +| OpenTelemetry export | ✅ | +| Slack alerts on errors | ✅ | +| Integration status API | ✅ | + + +| Tools | Status | +| - | - | +| Create or customize use-cases | ✅ | +| Pre-configured pagination | 🚫 (time to contribute: <48h) | +| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) | +| Per-customer configurations | ✅ | + + \ No newline at end of file diff --git a/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations-cc/PreBuiltUseCases.mdx b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations-cc/PreBuiltUseCases.mdx new file mode 100644 index 0000000000..aa7f4345e3 --- /dev/null +++ b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations-cc/PreBuiltUseCases.mdx @@ -0,0 +1,3 @@ +_No pre-built syncs or actions available yet._ + +Not seeing the integration you need? [Build your own](/guides/functions/functions-guide) independently. \ No newline at end of file diff --git a/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations/PreBuiltTooling.mdx b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations/PreBuiltTooling.mdx new file mode 100644 index 0000000000..962b838911 --- /dev/null +++ b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations/PreBuiltTooling.mdx @@ -0,0 +1,42 @@ +## Pre-built tooling + + +| 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 | ✅ | + + +| 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 | ✅ | + + +| Tools | Status | +| - | - | +| HTTP request logging | ✅ | +| End-to-end type safety | ✅ | +| Data runtime validation | ✅ | +| OpenTelemetry export | ✅ | +| Slack alerts on errors | ✅ | +| Integration status API | ✅ | + + +| Tools | Status | +| - | - | +| Create or customize use-cases | ✅ | +| Pre-configured pagination | 🚫 (time to contribute: <48h) | +| Pre-configured rate-limit handling | 🚫 (time to contribute: <48h) | +| Per-customer configurations | ✅ | + + \ No newline at end of file diff --git a/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations/PreBuiltUseCases.mdx b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations/PreBuiltUseCases.mdx new file mode 100644 index 0000000000..aa7f4345e3 --- /dev/null +++ b/docs/snippets/generated/microsoft-dynamics-365-finance-and-operations/PreBuiltUseCases.mdx @@ -0,0 +1,3 @@ +_No pre-built syncs or actions available yet._ + +Not seeing the integration you need? [Build your own](/guides/functions/functions-guide) independently. \ No newline at end of file diff --git a/packages/providers/providers.scopes.yaml b/packages/providers/providers.scopes.yaml index 114448834c..81fc286319 100644 --- a/packages/providers/providers.scopes.yaml +++ b/packages/providers/providers.scopes.yaml @@ -6243,6 +6243,14 @@ microsoft-ads: microsoft-business-central: - https://api.businesscentral.dynamics.com/.default +# source: Azure Portal API permissions picker for "Dynamics ERP" (Microsoft.ERP) +microsoft-dynamics-365-finance-and-operations: + - .default + - AX.FullAccess + - CustomService.FullAccess + - mcp.tools + - Odata.FullAccess + # source: https://learn.microsoft.com/en-us/graph/permissions-reference (Microsoft Entra ID uses standard Microsoft Graph permissions) microsoft-entra-id: - .default diff --git a/packages/providers/providers.yaml b/packages/providers/providers.yaml index 2c270b625e..e3395a4c16 100644 --- a/packages/providers/providers.yaml +++ b/packages/providers/providers.yaml @@ -12903,6 +12903,78 @@ microsoft-business-central: doc_section: '#step-2-finding-your-enrivonment-name' order: 2 +microsoft-dynamics-365-finance-and-operations: + display_name: Microsoft Dynamics 365 Finance and Operations + categories: + - erp + auth_mode: OAUTH2 + authorization_url: https://login.microsoftonline.com/${connectionConfig.tenantId}/oauth2/authorize + token_url: https://login.microsoftonline.com/${connectionConfig.tenantId}/oauth2/token + authorization_params: + response_type: code + resource: https://${connectionConfig.environmentUrl} + token_params: + grant_type: authorization_code + resource: https://${connectionConfig.environmentUrl} + refresh_params: + grant_type: refresh_token + resource: https://${connectionConfig.environmentUrl} + proxy: + base_url: https://${connectionConfig.environmentUrl} + docs: https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations + docs_connect: https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/connect + setup_guide_url: https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations/how-to-register-your-own-microsoft-dynamics-365-finance-and-operations-api-oauth-app + connection_config: + tenantId: + type: string + title: Tenant ID + description: The unique identifier for your organization that uses the Finance and Operations Microsoft services. + format: uuid + example: a1b2c3d4-e5f6-47a8-9b0c-d1234567890f + doc_section: '#step-1-finding-your-tenant-id' + order: 1 + environmentUrl: + type: string + title: Environment URL + description: The domain of your Finance and Operations environment. + example: mycompany.operations.dynamics.com + format: hostname + prefix: https:// + doc_section: '#step-2-finding-your-environment-url' + order: 2 + +microsoft-dynamics-365-finance-and-operations-cc: + display_name: Microsoft Dynamics 365 Finance and Operations (Client Credentials) + categories: + - erp + auth_mode: OAUTH2_CC + token_url: https://login.microsoftonline.com/${connectionConfig.tenantId}/oauth2/v2.0/token + token_params: + grant_type: client_credentials + scope: https://${connectionConfig.environmentUrl}/.default + proxy: + base_url: https://${connectionConfig.environmentUrl} + docs: https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc + docs_connect: https://nango.dev/docs/api-integrations/microsoft-dynamics-365-finance-and-operations-cc/connect + connection_config: + tenantId: + type: string + title: Tenant ID + description: The unique identifier for your organization that uses the Finance and Operations Microsoft services. + format: uuid + example: a1b2c3d4-e5f6-47a8-9b0c-d1234567890f + doc_section: '#step-1-finding-your-tenant-id' + order: 1 + environmentUrl: + type: string + title: Environment URL + description: The domain of your Finance and Operations environment. + example: mycompany.operations.dynamics.com + format: hostname + prefix: https:// + doc_section: '#step-2-finding-your-environment-url' + order: 2 + microsoft-ads: display_name: Microsoft Ads alias: microsoft diff --git a/packages/webapp/public/images/template-logos/microsoft-dynamics-365-finance-and-operations-cc.svg b/packages/webapp/public/images/template-logos/microsoft-dynamics-365-finance-and-operations-cc.svg new file mode 120000 index 0000000000..d3e984d036 --- /dev/null +++ b/packages/webapp/public/images/template-logos/microsoft-dynamics-365-finance-and-operations-cc.svg @@ -0,0 +1 @@ +microsoft-dynamics-365-finance-and-operations.svg \ No newline at end of file diff --git a/packages/webapp/public/images/template-logos/microsoft-dynamics-365-finance-and-operations.svg b/packages/webapp/public/images/template-logos/microsoft-dynamics-365-finance-and-operations.svg new file mode 100644 index 0000000000..7bf8818989 --- /dev/null +++ b/packages/webapp/public/images/template-logos/microsoft-dynamics-365-finance-and-operations.svg @@ -0,0 +1,44 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +