Business Connect
Business Connect is a specialized integration module built for ERP developers, functional consultants, and integrators working with enterprise resource planning systems. It's the power-user counterpart to the standard External API setup — instead of defining endpoints one at a time, Business Connect lets you authenticate against your ERP instance and import the full API surface in a single step.
Business Connect is designed for users who already understand their ERP's API model. If you're not familiar with concepts like tenants, endpoint versions, or OAuth scopes, work with your ERP administrator to gather the required credentials before continuing.
Supported ERPs
Business Connect currently supports the following ERP vendors:
Acumatica
Microsoft Dynamics 365 Business Central
Sage
Each vendor exposes a different set of connection parameters — described in detail below.
How It Differs from the Standard Setup
API discovery
Manual entry or OpenAPI schema upload
Automatic import using ERP instance credentials
Setup style
Endpoint-by-endpoint configuration
One-time vendor configuration, full API surface imported
Target user
General developers / integrators
ERP developers, functional consultants
Authentication
Basic, API Key, Bearer, JWT, OAuth 2.0
Vendor-specific (OAuth 2.0, username/password)
Best for
Any third-party REST API
Acumatica, Dynamics 365, Sage integrations
The Business Connect Wizard
Business Connect runs as a 4-step wizard:
Select the type of connector — choose your ERP vendor (Acumatica, Dynamics 365, or Sage)
Enter connector information — provide instance URL, credentials, and authentication details
Select function — pick which endpoints to import
Select collection to save — choose where to file the imported endpoints
The sections below walk through each step.
Step 1 & 2: Configuring the Connection
Acumatica exposes its data through contract-based REST endpoints, where each endpoint is a versioned, named bundle of entities (e.g., the built-in Default endpoint, or any custom endpoint you've extended in the Web Service Endpoints screen, SM207060). Business Connect authenticates against the Acumatica instance's built-in identity server and pulls in the entity schema for the endpoint you select.
ERP context:
Each Acumatica tenant runs its own identity server at
Base URL + /identity/connect/tokenThe combination of Endpoint Name + Endpoint Version determines which entities (e.g.,
Customer,SalesOrder,Bill) are exposed and what fields they carryMulti-tenant Acumatica instances require the Tenant Name (called Company in Acumatica's UI) so the token is scoped to the right database
Required fields:
Base URL (required) — your Acumatica instance URL e.g.,
https://your-company.acumatica.comEndpoint Version (required) — the contract-based endpoint version configured under Web Service Endpoints e.g.,
22.200.001Endpoint Name (required) — the endpoint to expose e.g.,
DefaultTenant Name (optional) — the Acumatica tenant/company; required for multi-tenant instances e.g.,
Company
Authentication Type: OAuth 2.0 or No Auth
Use No Auth only for endpoints intentionally exposed without authentication (rare, typically internal sandboxes). Production Acumatica instances should always use OAuth 2.0.
When using OAuth 2.0, only the Password Credentials grant type is supported. Provide:
Access Token URL — defaults to
Base URL + /identity/connect/tokenUsername (required) — Acumatica user (the same login used in the Acumatica UI)
Password (required) — Acumatica user password
Client ID (required) — Client ID from the Acumatica Connected Applications record (
SM303010) e.g.,xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxClient Secret (required) — Client Secret generated alongside the Client ID
Scope (required) — OAuth scopes e.g.,
api offline_access(useoffline_accessif you need refresh token support)
Register the Connected Application in Acumatica under System → Integration → Connected Applications, choose the Resource Owner Password Credentials flow, and assign it to the Acumatica user whose credentials you'll enter here.
Microsoft Dynamics 365 Business Central exposes data through two API surfaces: the standard REST API (Microsoft's published, versioned API at /api/v2.0/...) and OData v4 (the underlying protocol used by published pages and queries). Business Connect lets you target either, and authenticates through Microsoft Entra ID (Azure AD).
ERP context:
Business Central is multi-tenanted on Microsoft Entra — the Tenant ID identifies your Entra tenant, and the Environment identifies the Business Central environment within it (e.g.,
Production,Sandbox)Each environment can host multiple Companies (Business Central's term for a chart-of-accounts / legal-entity boundary). Leave it blank to import companies; specify one to scope the import
Service-to-service integrations should use client credentials with an Azure App Registration that has been granted the
API.ReadWrite.Allpermission (or equivalent) on the Business Central API
Required fields:
API Base URL (required) e.g.,
https://api.businesscentral.dynamics.comBusiness Central instance version (required) — the API version path segment e.g.,
v2.0Tenant ID (required) — your Microsoft Entra tenant GUID e.g.,
11111111-2222-3333-4444-555555555555Environment (required) — Business Central environment name e.g.,
ProductionCompany (optional) — Business Central company display name e.g.,
CRONUS USA, Inc.
API Type: API (Microsoft's standard REST API) or OData v4
Choose API for the official, version-stable Business Central REST endpoints (recommended for most integrations). Choose OData v4 when you need to call published pages, queries, or AL-extended endpoints that aren't surfaced through the standard API.
Authentication Type: Client Credentials (OAuth 2.0) or No Auth
When using Client Credentials, provide:
Access Token URL (required) e.g.,
https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/tokenClient ID (required) — Azure App Registration (Application) ID
Client Secret (required) — secret generated under Certificates & secrets in the App Registration
Scope (required) e.g.,
https://api.businesscentral.dynamics.com/.default
Replace {tenant-id} in the Access Token URL with the actual Tenant ID GUID. The Azure App Registration must have the Dynamics 365 Business Central API permission granted with admin consent, and the same App ID must be registered as an admin user inside Business Central (Users → New → S2S Authentication).
Business Connect supports Sage's REST APIs (e.g., Sage 200, Sage X3, Sage Intacct via partner endpoints) where the API is reached through a tenant- and company-scoped base path. Sage authenticates with username/password over HTTPS — there is no OAuth flow on the Business Connect path today.
ERP context:
Sage's API is namespaced by Tenant (your Sage subscription) and Company (the legal entity / dataset within that tenant)
The Base Path identifies the Sage module being targeted (e.g.,
/accountsfor the financials module). Different modules expose different entity setsThe API Version is part of the URL contract — keep it pinned to a known-good version to avoid breaking changes when Sage rolls out updates
Required fields:
API Base URL (required) e.g.,
https://api.sage.comAPI Version (required) e.g.,
3.1Base Path (required) — the Sage module path e.g.,
/accountsTenant Name (required) — your Sage tenant identifier e.g.,
your-tenant-nameCompany (required) — Sage company / dataset identifier e.g.,
your-company-id
Authentication Type: Basic Auth or No Auth
When using Basic Auth, provide:
Username (required)
Password (required)
Use a dedicated API/integration user in Sage rather than a named human user — Sage tracks API activity against the login used, and tying it to a service account makes audit and rotation easier.
Step 3: Selecting the Endpoints to Import
Once the connection is validated, Business Connect queries the ERP instance and lists every available endpoint. ERP APIs are large — Acumatica's Default endpoint alone can expose hundreds of entities, and a fully extended Dynamics 365 environment can surface thousands of endpoints. Step 3 is where you cut that list down to only what your application actually uses.
Business Connect can technically import hundreds of endpoints — close to unlimited — but doing so is strongly discouraged. Every imported endpoint adds context the AI must reason over during app generation, which directly increases generation cost and latency. Most applications only use a small fraction of the ERP's surface area; import only those.
How the selection screen works
Grouped by HTTP method, then by name — endpoints are organized first by type (
GET,POST,PUT,PATCH,DELETE) and then alphabetically by endpoint name, making it easy to scan related operations together (e.g., allGETreads, allPOSTcreates)Per-endpoint checkboxes — tick the checkbox beside any endpoint to include it in the import
Search bar — filter the list by name to quickly locate the entities you need (e.g.,
Customer,SalesOrder,Item)Select All / Deselect All — bulk-toggle the entire (or filtered) list when you need to start from a clean slate or include everything in a small endpoint group
Selection guidance
Start by deselecting all, then add back only the endpoints your app needs
Pick endpoints based on the user stories the app will support (e.g., "list customers", "create sales order") — not "everything related to sales"
Prefer
GETreads first — only addPOST/PUT/PATCH/DELETEfor entities the app will actually write toIf you're unsure whether an endpoint is needed, leave it out — you can always rerun Business Connect later to add more
Step 4: Choosing the Collection
In the final step, pick the collection the selected endpoints will be saved into. Collections are the same containers used by the rest of the External API flow — you can:
Save into an existing collection to keep all endpoints for one ERP under a single connector
Create a new collection for a clean separation (e.g., one collection per ERP module, or one per app)
Once saved, the imported endpoints behave exactly like any other External API function — they appear in the AI's available toolset during app generation, can be combined with custom External API connections, and can be edited or extended after import.
Tips
Confirm your ERP credentials work outside eMOBIQ AI first (e.g., via the vendor's own API explorer or Postman)
Use a service account rather than a personal account where possible — credentials persist with the connection
Keep Client Secrets in a secrets manager and rotate them on the schedule mandated by your ERP vendor
For OAuth-based ERPs (Acumatica, Dynamics 365), make sure the registered application allows the grant type you select and includes the scopes Business Connect needs
Related
External API — the general-purpose API setup
OAuth 2.0 — OAuth grant types reference
EZ-Connect — natural-language API setup for prototyping
Last updated