A HubSpot Elite Solutions Partner built to help organizations unify strategy, systems, and execution. We design HubSpot systems that scale.

See how we've solved complex HubSpot challenges across migrations, integrations, CMS, automation, and optimization.

Join a team building smarter HubSpot systems. We value strategic thinkers who move proactively, care about quality, and want to do meaningful work.

Integration

HubSpot <> Dynamics 365 Finance & SCM Integration

Powered by Commercient
HubSpot and Dynamics 365 Finance & SCM integration
Integration Assessment
Integration Assessment · ERP

Dynamics 365 Finance & Supply Chain Management × HubSpot

How customers, released products, sales quotations, sales orders, invoices and receivables across several legal entities in Microsoft Dynamics 365 Finance and Supply Chain Management can reach HubSpot, and how won deals flow back into the ERP.

OData data entitiesData management package APIBusiness eventsCustom servicesMicrosoft Entra ID (OAuth 2.0)Multiple legal entities
Platform ownerMicrosoft
Integration typeCustom middleware
Primary directionTwo-way, ERP owns finance
FeasibilityBuildable, enterprise scope
API accessOpen API
01 — Summary

Does Dynamics 365 Finance & SCM integrate with HubSpot?

Finance and Supply Chain Management is Microsoft's ERP for large and multinational companies. It runs customers, products, quotations, orders, invoicing and receivables across many legal entities, with financial dimensions on almost every record. HubSpot holds the people, the pipeline and the conversations.

API access
Open APIOpen with conditionsGated API

Public documentation. The client's own admin issues credentials, with no vendor approval needed.

Open API. OData entities are documented publicly. The client's administrator registers a Microsoft Entra application and maps it to a user.

Based on the vendor's public documentation. Access terms are confirmed with the vendor and the client in discovery.

Every record a seller needs is exposed as a data entity, so HubSpot can carry the full quote-to-cash picture across legal entities.

Campaign Creators assessment

Microsoft exposes Finance and Supply Chain Management through OData data entities, the Data management package REST API for bulk and incremental loads, business events for change notifications, and custom services for logic the entities do not cover. All of them authenticate through Microsoft Entra ID. There is no codeless HubSpot app for this ERP, so the integration is a custom build. Its size comes from the ERP itself: several legal entities, financial dimensions, global address book parties, and enterprise data volumes.

Scorecard
Data richnessVery high
API accessDocumented, admin setup
Public docsExtensive
Build complexityHigh

Ratings are CC judgments from Microsoft's public documentation. Entity names, extensions and enabled business events are confirmed against the client's environment in discovery.

Strength

Data entities for every sales record

Customers (CustomersV3), released products V2, sales quotation headers, sales order headers and sales invoice headers are documented entities that can be read and written through OData, and exported in bulk through data management.

Plan for

Legal entities and dimensions

Each customer, order and invoice belongs to one legal entity (dataAreaId) and carries financial dimensions. HubSpot needs a clear rule for how one company that buys from several legal entities appears in the CRM.

Gate

Environment access and ALM

An administrator registers a Microsoft Entra application and maps it to a user in Finance and Supply Chain Management. Any new entity, field or business event goes through the client's own release process.

02 — API modules

Which Dynamics 365 Finance & SCM APIs does the integration use?

Seven surfaces matter to a HubSpot build. Three carry the data, three move or trigger it, and one is a scope decision made at the start.

Core

Customers & contacts

CustomersV3 · contact persons

Customer accounts with organization name, customer group, currency, payment terms, credit limit, on-hold status, responsible employee and default financial dimensions.

  • Customer account becomes a HubSpot Company
  • Contact persons become associated HubSpot Contacts
  • Party number links the same organization across legal entities
Core

Released products & prices

Released products V2 · trade agreements

Products released to each legal entity, with item number, search name, product group, sales unit and base sales price. Customer-specific prices live in trade agreements.

  • Released products become HubSpot Products
  • Item number is the shared SKU
  • Customer price agreements stay in the ERP
Core

Quotations, orders & invoices

Sales quotation headers V2 · SalesOrderHeadersV2 · sales invoice headers

Sales quotations (including for prospects), sales orders with lines, posted sales invoices and free-text invoices, each in one legal entity and currency.

  • Won deal creates a quotation or sales order
  • Order and invoice status return to HubSpot
  • Free-text invoices cover services and non-stock billing
Bulk & delta

Data management package API

ExportToPackage · ImportFromPackage

Moves data in and out as packages through a data project. With change tracking on, exports return only records created or changed since the last run.

  • Used for backfill and nightly deltas
  • Exempt from service protection throttling
  • Status and error files for every run
Triggers

Business events

Business event catalog · HTTPS, Service Bus, Event Grid

Notifications when a business process runs, activated per legal entity in the business event catalog. Custom events can be added through an extension.

  • Each payload has a control number for de-duplication
  • Delivery order is not guaranteed
  • Used as a signal; data is read through OData
Extension

Custom services

X++ services · JSON and SOAP endpoints

Service operations written in X++ for logic the data entities do not expose, such as a single call that returns a customer's open balance across legal entities.

  • Built in the client's ERP codebase
  • Follows the client's release process
  • Use only where entities fall short
Scope decision

Legal entity model in HubSpot

One company or one per legal entity

A buyer can be a customer in several legal entities with a different account number in each. The team decides whether HubSpot shows one company with child records per legal entity, or one company per account.

  • Decide before the data model is built
  • Party number as the cross-entity key
  • Record the rule in the SOW
03 — Framework

How does the Dynamics 365 Finance & SCM HubSpot integration work?

A CC-built integration layer reads Finance and Supply Chain Management through OData and data management exports, listens for business events, matches records to HubSpot and writes in batches. Won deals travel the other way as sales quotations or sales orders in the right legal entity.

Dynamics 365 Finance & SCM
CustomersV3customer accounts by legal entity
Released products V2items and base prices
Quotations, orders, invoicesheader and line entities
Business eventsorder, invoice and custom triggers
CC integration layer
Event receivercontrol number check, queue
Delta readerpackage exports with change tracking
Entity resolverparty number · customer account · dataAreaId
Document builderwon deal → quotation or sales order
HubSpot writerbatch upserts, error replay
HubSpot
Companiesorganizations and legal-entity accounts
Contactscontact persons
Products & line itemsreleased products and document lines
Deals, quotes & orderspipeline through fulfillment
Invoicesposted invoices and open balance
Finance & SCM → HubSpot (customers, products, documents, receivables)HubSpot → Finance & SCM (new customers and won deals as quotations or orders)
Principle

Each system owns its own facts

HubSpot owns contacts, marketing and pipeline. Finance and Supply Chain Management owns customer accounts, prices, credit, orders, invoices and receivables. Neither overwrites the other's fields.

Principle

Legal entity on every record

Every ERP record written to HubSpot carries its legal entity code, and every document HubSpot sends names the legal entity it belongs to.

Principle

Bulk by package, changes by event

Large loads and nightly deltas go through data management packages. Business events and targeted OData reads handle what changes during the day.

04 — Process

What does Dynamics 365 Finance & SCM HubSpot integration setup involve?

Each phase ends on a gate the client signs off before the next begins. Legal entities are delivered in waves, so the first is live while the next is being configured.

1

Discovery & legal entities

List the legal entities, customer groups, financial dimensions, extensions and sales processes in scope. Agree the legal entity model in HubSpot and which system owns each field.

Gate to next phaseSigned legal entity model and ownership table
2

Access & environments

Register the Microsoft Entra application, map it to a least-privilege user in Finance and Supply Chain Management, and confirm a sandbox environment with representative data.

Gate to next phaseToken works against OData and data management in sandbox
3

Entity & event setup

Confirm the entities to use, create data projects with change tracking, activate the business events needed per legal entity, and specify any custom entity or service for the client's developers.

Gate to next phaseData projects export deltas; events reach the test endpoint
4

HubSpot data model

Create the fscm_ properties, company hierarchy or association labels, deal stages that trigger ERP documents, and order and invoice properties in a HubSpot sandbox.

Gate to next phaseSchema approved and created in sandbox
5

Build

Build the event receiver, delta reader, entity resolver, document builder and batch writer, with idempotent writes, retry on 429, and an error replay queue.

Gate to next phaseOne legal entity syncing end to end in sandbox
6

Backfill

Load customers, contacts, released products and an agreed window of orders and invoices per legal entity through package exports.

Gate to next phaseCounts and open balances reconcile to ERP reports per legal entity
7

Parallel run & launch

Run live for two weeks with outbound document creation in review mode, then switch on and add remaining legal entities in waves.

Gate to next phaseFive consecutive days with no unresolved sync errors
05 — Data mapping

What does the Dynamics 365 Finance & SCM HubSpot integration sync?

Entity and field names come from Microsoft's data entity documentation. Where a name is marked for confirmation, it is checked against the client's OData metadata in discovery, because extensions and versions can change entities.

Finance & SCM fieldHubSpot propertyObjectDirectionNotes
Customers & contacts · CustomersV3
CustomerAccountfscm_customer_accountCompany↔ BothKey, together with legal entity. Written to HubSpot on create.
dataAreaIdfscm_legal_entityCompany↔ BothLegal entity code. Required on every write.
PartyNumberfscm_party_numberCompanyF&SCM → HSSame organization across legal entities.
OrganizationNamenameCompany↔ BothHubSpot creates; ERP keeps its own on later edits.
AddressCity, AddressState, AddressCountryRegionIdcity, state, countryCompany↔ BothFill blanks only after create.
CustomerGroupIdfscm_customer_groupCompanyF&SCM → HS
SalesCurrencyCodefscm_currencyCompanyF&SCM → HS
CreditLimitfscm_credit_limitCompanyF&SCM → HSRead-only in HubSpot.
OnHoldStatusfscm_on_holdCompanyF&SCM → HSDrives a credit-hold flag for sellers.
EmployeeResponsibleNumberhubspot_owner_idCompanyF&SCM → HSMapped through a worker-to-owner table.
DefaultDimensionDisplayValuefscm_default_dimensionsCompanyF&SCM → HSFinancial dimensions as one display string.
PrimaryContactEmail / contact personsemail, firstname, lastnameContact↔ BothAssociated to the company. Contact person entity confirmed in discovery.
Released products · Released products V2 entity
ItemNumberhs_skuProductF&SCM → HSShared key for products and line items.
SearchNamenameProductF&SCM → HSConfirm the display name field in discovery.
SalesPricepriceProductF&SCM → HSBase price. Customer prices stay in trade agreements.
ProductGroupIdfscm_product_groupProductF&SCM → HS
Quotations & orders
Deal (closed won) + line itemsSales quotation or sales orderDealHS → F&SCMHeader first, then lines, in the deal's legal entity.
SalesQuotationNumber, SalesQuotationStatusfscm_quotation_number, fscm_quotation_statusDealF&SCM → HSQuotations can also be raised for prospects (ProspectId).
SalesQuotationExpiryDatefscm_quotation_expiryDealF&SCM → HS
SalesOrderNumberfscm_sales_order_numberOrderF&SCM → HSOrder associated to the deal and company.
Sales order statusfscm_order_statusOrderF&SCM → HSOpen, delivered, invoiced. Confirm field name in discovery.
Sales order linesLine itemsOrderF&SCM → HSItem number, quantity, price, from the sales order lines entity.
Invoices & receivables
InvoiceNumberfscm_invoice_numberInvoiceF&SCM → HSPosted sales invoices; free-text invoices included if in scope.
InvoiceDatefscm_invoice_dateInvoiceF&SCM → HS
TotalInvoiceAmount, TotalTaxAmountfscm_invoice_total, fscm_tax_totalInvoiceF&SCM → HSIn invoice currency.
SalesOrderNumber (on invoice)Association to OrderInvoiceF&SCM → HSLinks invoice to its order.
Open amount and due datefscm_open_amount, fscm_due_dateInvoiceF&SCM → HSFrom open customer transactions. Entity confirmed in discovery.
Customer balance (all legal entities)fscm_open_balanceCompanyF&SCM → HSSummed in the integration layer or a custom service.
06 — Auth & API

How are authentication and API limits handled?

Finance and Supply Chain Management uses Microsoft Entra ID for service access. Throttling values are from Microsoft's service protection documentation for online environments.

TopicFinance & SCMHubSpot
InterfacesOData v4 at {environment}/data/ for public data entities; Data management package REST API for bulk import and export; custom services (JSON and SOAP) for X++ logic.REST APIs: CRM objects, commerce objects, associations, imports.
AuthenticationOAuth 2.0 client credentials through a Microsoft Entra application. The client ID is added under System administration › Setup › Microsoft Entra applications and mapped to a user whose roles set what it can read and write.Private app access token or OAuth 2.0 public app, scoped per object.
Legal entitiesOData returns the user's default company unless cross-company=true is added; filter on dataAreaId for one legal entity. Package exports take a legal entity ID.One portal. Legal entity stored as a property on every ERP record.
Change notificationsBusiness events to HTTPS, Azure Service Bus or Azure Event Grid endpoints, activated per legal entity. Payload includes a control number; order is not guaranteed.HubSpot webhooks for outbound triggers on deals and companies.
Paging & batchingServer-driven paging up to 10,000 records per page. Batch requests with atomic changesets. $expand one level deep.Batch endpoints up to 100 records per call.
ThrottlingResource-based throttling returns HTTP 429 with Retry-After when the environment is under load. Data management and recurring integrations are exempt. Exact thresholds are not published; confirm with Microsoft.Per-10-second burst and daily limits by subscription tier.
Change controlNew entities, fields, events or services are X++ extensions deployed through the client's release process.Custom properties on every paid tier. Custom objects need an Enterprise hub.
07 — Issues & opportunities

What should you plan for, and what does the integration unlock?

Severity reflects impact on the SOW, not technical difficulty alone.

Challenges to plan for

One buyer, several legal entitiesHigh

The same organization can hold a different customer account in each legal entity. Without an agreed model, HubSpot shows duplicate companies or mixes balances. Decide the model in discovery and key on party number plus legal entity.

Client-side development may be neededHigh

Contact persons, open balances or custom fields may need a custom entity or service. That work sits in the client's ERP codebase and release cycle, so it is a dated dependency in the SOW.

Volume and backfill timeMedium

Enterprise order and invoice history is large. Backfill runs through package exports by legal entity and date window, and HubSpot receives only the history the team will use.

Financial dimensions are wideMedium

Dimensions are configured per client and can be many. HubSpot receives the few that drive reporting as separate properties, and the full string for reference.

Events are signals, not dataMedium

Business events are kept small and can arrive out of order. The integration treats each event as a prompt to read the current record, and a nightly delta export catches anything missed.

Currency and tax by legal entityLow

Each legal entity has its own currency and tax setup. HubSpot multi-currency is set up before backfill, and totals are shown as the ERP reports them.

Opportunities in HubSpot

Credit and on-hold status on every accountHigh value

Sellers see credit limit, on-hold status and open balance before they quote, so no one promises an order finance will block.

Won deals become ERP documentsHigh value

Closing a deal creates the quotation or sales order in the right legal entity, with the right customer account and items, without re-keying.

One view of a global customerHigh value

A parent company in HubSpot shows orders, invoices and balances from every legal entity the customer buys from.

Billed revenue next to pipelineMedium value

Posted invoices and order lines let HubSpot report actual revenue by product, owner, region and dimension beside forecast.

Prospect quotations in the CRMMedium value

Quotations raised for prospects appear on the HubSpot deal, so marketing and sales see quote activity before the account exists in the ERP.

Service with order contextMedium value

Service tickets show recent orders, delivery status and open invoices on the same company record.

Quote-to-cash flow

One deal, from first call to paid invoice.

Each step happens in the system that owns it, and the other system sees the result. HubSpot runs the sale; Finance and Supply Chain Management runs fulfillment and finance in the right legal entity.

  1. HubSpot: the deal, its contacts and its line items are built from released products, with the legal entity set on the deal.
  2. On closed won, the integration creates the customer account if needed, then a sales quotation or sales order in that legal entity.
  3. The ERP delivers and posts the invoice; order and invoice status return to HubSpot.
  4. Settlement clears the open amount, the invoice shows paid, and the account team sees it.
08 — Property schema

Which HubSpot properties does the integration create?

All custom properties use the fscm_ prefix in a Finance & SCM property group. Finance fields are read-only for HubSpot users.

Internal nameLabelObjectTypeSource / logic
fscm_customer_accountCustomer AccountCompanySingle-line textCustomerAccount; unique with legal entity
fscm_legal_entityLegal EntityCompanyDropdowndataAreaId
fscm_party_numberParty NumberCompanySingle-line textPartyNumber; cross-entity key
fscm_customer_groupCustomer GroupCompanyDropdownCustomerGroupId
fscm_credit_limitCredit LimitCompanyNumber (currency)CreditLimit
fscm_on_holdOn HoldCompanyDropdownOnHoldStatus
fscm_open_balanceOpen BalanceCompanyNumber (currency)Sum of open customer transactions
fscm_default_dimensionsDefault DimensionsCompanySingle-line textDefaultDimensionDisplayValue
fscm_quotation_numberQuotation No.DealSingle-line textSalesQuotationNumber
fscm_sales_order_numberSales Order No.OrderSingle-line textSalesOrderNumber
fscm_invoice_numberInvoice No.InvoiceSingle-line textInvoiceNumber
fscm_open_amountOpen AmountInvoiceNumber (currency)Open customer transaction amount
09 — Scope builder

Interactive scope builder

Choose the objects and fields for this engagement and the direction each one syncs. Required fields are the keys the integration cannot run without. Copy the summary into the SOW or a reply to the client.

Scope summary

0Fields
0Inbound
0Write-back
Finance & SCM × HubSpot Integration Assessment · Designed by Campaign Creators, Elite HubSpot Solutions Partner

Dynamics 365 Finance & SCM HubSpot integration FAQ

Does Dynamics 365 Finance & SCM integrate with HubSpot?

Yes, through a custom integration. There is no codeless HubSpot app for Finance and Supply Chain Management, so Campaign Creators builds on Microsoft's OData data entities, the Data management package REST API, business events and custom services, all authenticated through Microsoft Entra ID.

What data syncs between Dynamics 365 Finance & SCM and HubSpot?

Customers, contacts and released products sync to HubSpot companies, contacts and products. Won HubSpot deals can create sales quotations or sales orders in the ERP. Orders, invoices, open balances and the financial dimensions that drive reporting are written back to HubSpot.

How are multiple legal entities handled?

Every customer, order and invoice belongs to one legal entity and carries financial dimensions. The legal entity model is agreed in discovery, records are keyed on party number plus legal entity so balances never mix, and legal entities go live in waves.

What does setting up the Dynamics 365 Finance & SCM HubSpot integration involve?

Seven phases, each closed by a client sign-off: discovery and legal entities, access and environments, entity and event setup, the HubSpot data model, the build, backfill per legal entity, and a two-week parallel run before outbound document creation is switched on.

How long does the integration take and what does it cost?

Timeline and cost depend on the legal entities, financial dimensions, extensions and history in scope, and on any custom entities the client's developers need to add. Campaign Creators confirms these in discovery and provides a fixed scope before the build starts.

Ready to Get More From HubSpot?

Whether you’re implementing HubSpot, optimizing what you already have, connecting systems, or scaling your customer experience, we’ll help you figure out the right next step.