| name | microsoft-dynamics-365-business-central |
| description | A comprehensive business management solution that helps small and mid-sized companies manage finances, operations, sales, and customer service in a connected environment. Read and write Microsoft Dynamics 365 Business Central data through One: defaultdimensions, items, salesinvoices, salesquotes, attachments, bankaccounts and more, 260 actions with real parameter documentation. Use whenever the user asks to look something up in Microsoft Dynamics 365 Business Central, create or update a record there, or build code against the Microsoft Dynamics 365 Business Central API. |
Microsoft Dynamics 365 Business Central through One
A comprehensive business management solution that helps small and mid-sized companies manage finances, operations, sales, and customer service in a connected environment.
One exposes Microsoft Dynamics 365 Business Central through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.
How to run an action
- Find the action in the table below, or call
search_one_platform_actions with platform microsoft-dynamics-365-business-central if it is not listed.
- Call
get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
- Call
execute_one_action with parameters copied from that knowledge.
Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.
Before you start
Call list_one_integrations once and confirm Microsoft Dynamics 365 Business Central is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.
Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.
Before a write
Creates, updates, deletes and sends land on a real Microsoft Dynamics 365 Business Central account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.
Actions
DefaultDimensions
| Action | Method | Path | Action id |
|---|
| Get a Customer’s Default Dimensions | GET | /customers({{customerId}})/defaultDimensions | conn_mod_def::GJ46yJP5PW0::11fSSHU7Sv-bGyVkEMO-dQ |
| List a Vendor’s Default Dimensions (for a Company) | GET | /vendors({{vendorId}})/defaultDimensions | conn_mod_def::GJ466RhA7-c::L4YE7jgdT3GP2i-mKISUzQ |
| List Default Dimensions for an Entity | GET | /defaultDimensions | conn_mod_def::GJ46zIhU-dE::y3RkyS88SLm7LXX9OBZOXw |
| Create a Customer’s Default Dimensions | POST | /customers({{customerId}})/defaultDimensions | conn_mod_def::GJ46x9tA7s0::5_v1LrPgTk2-kMNz8eTUCw |
| Create a Default Dimension for an Entity | POST | /items({{itemId}})/defaultDimensions | conn_mod_def::GJ46zBZ4ukY::NZi8MuEZSJ6M7Lm9mc9-zQ |
| Create a Vendor’s Default Dimensions | POST | /vendors({{vendorId}})/defaultDimensions | conn_mod_def::GJ466Cl7Rqs::t_OaQmygTneJSHAvxq640Q |
| Create an Employee’s Default Dimensions | POST | /employees({{employeeId}})/defaultDimensions | conn_mod_def::GJ46zrwfEzY::YfK-pnX4QPiR_pYwKv5hFA |
| Delete a Company Entity’s Default Dimension | DELETE | /{{entityPath}}/defaultDimensions({{defaultDimensionId}}) | conn_mod_def::GJ46y81e5t8::lZTYeD78S_iBNQeBjbZC6g |
| Delete a Vendor’s Default Dimension | DELETE | /vendors({{vendorId}})/defaultDimensions({{vendorId}},{{dimensionId}}) | conn_mod_def::GJ466R0RSy8::5G9VDuOGR5WSEurxO8wdSg |
| Update a Company's Entity Default Dimension | PATCH | /items({{itemId}})/defaultDimensions({{defaultDimensionId}}) | conn_mod_def::GJ46zLFySDM::Oh6pOl6ST8ercuY38R4fbQ |
| Update a Customer’s Default Dimensions (in a Company) |
Items
| Action | Method | Path | Action id |
|---|
| Get a Company’s Item | GET | /items({{itemId}}) | conn_mod_def::GJ460mRGlw0::i1eds37ZTM6bU2T4Vkn7CQ |
| Get an Item’s Picture | GET | /items({{itemId}})/picture | conn_mod_def::GJ460mPuahA::eOY-Qm33T1imys3M2FW4fw |
| Create an Item for a Company | POST | /items | conn_mod_def::GJ460dxQrIM::Iz1gIKocSISsCHhIMaOx1Q |
| Delete a Company's Item | DELETE | /items({{itemId}}) | conn_mod_def::GJ460maOkqU::5TfzFuJcRGCRnuIUQpk5tA |
| Delete an Item’s Picture (in a Company) | DELETE | /items({{itemId}})/picture | conn_mod_def::GJ460d2yzvs::YBe_50UVTQeN5SAltFNCgA |
| Update a Company's Item | PATCH | /items({{itemId}}) | conn_mod_def::GJ460nxVgDw::ZYj1HgBaRCyq3uGvIPStBg |
SalesInvoices
| Action | Method | Path | Action id |
|---|
| Get a Company’s Sales Invoice | GET | /salesInvoices({{salesInvoiceId}}) | conn_mod_def::GJ464FlqXgo::lPO2U-9bQg6RIhrznoqkVA |
| Get a Sales Invoice PDF Document (binary) | GET | /salesInvoices({{invoiceId}})/pdfDocument({{invoiceId}})/content | conn_mod_def::GJ464F064ww::o5cRUnQLSMqocVzvYIJXxg |
| Create a Company's Sales Invoice | POST | /salesInvoices | conn_mod_def::GJ464E-8BrE::LPbl0JBWSFmFzlDid8M1Ig |
| Delete a Company's Sales Invoice | DELETE | /salesInvoices({{salesInvoiceId}}) | conn_mod_def::GJ464GKyIG4::b2mQOBQgRIaKbM4Dbxtqtw |
| Update a Company's Sales Invoice | PATCH | /salesInvoices({{salesInvoiceId}}) | conn_mod_def::GJ464Tv0y5I::bMu21hONRqutdYi3DXowvA |
SalesQuotes
| Action | Method | Path | Action id |
|---|
| Get a Company’s Sales Quote | GET | /salesQuotes({{salesQuoteId}}) | conn_mod_def::GJ465BbTPKk::2Fd5Ft5JQsOacLPgrkxv7w |
| Get a Sales Quote PDF Document (Binary Content) | GET | /salesQuotes({{quoteId}})/pdfDocument({{pdfDocumentId}})/content | conn_mod_def::GJ46413eLYs::eKOIaRf0Sdm0bijTxICYxw |
| Create a Company's Sales Quote | POST | /salesQuotes | conn_mod_def::GJ4640hou9Q::KNjjuykiTb-65xJgP3UUJg |
| Delete a Company's Sales Quote | DELETE | /salesQuotes({{salesQuoteId}}) | conn_mod_def::GJ46409MMD4::kB-8FnJATJarmn5neejv8g |
| Update a Company's Sales Quote | PATCH | /salesQuotes({{salesQuoteId}}) | conn_mod_def::GJ465CVbh0Y::PKyBE8EITg6o6KaqCD4wlQ |
Attachments
| Action | Method | Path | Action id |
|---|
| List Company Attachments (Filtered by Parent Entity) | GET | /attachments | conn_mod_def::GJ46w74l8xM::AGbmnwSwRTWzWUmnyoJ0hA |
| Create a Company's Attachment (Incoming Document) | POST | /attachments | conn_mod_def::GJ46w7KDQWY::iDpQXZ8IQyGJR1WjftpvEQ |
| Delete a Company Attachment | DELETE | /attachments({{attachmentId}}) | conn_mod_def::GJ46w7tfcWc::X0tNQY1iRM-dNKi1wCoNwg |
| Update an Attachment’s Content (Incoming Document) | PATCH | /attachments({{attachmentId}})/attachmentContent | conn_mod_def::GJ46w7rcNMU::ia8-mmibTA6EV9wa72dT4w |
BankAccounts
| Action | Method | Path | Action id |
|---|
| Get a Company's Bank Account | GET | /bankAccounts({{bankAccountId}}) | conn_mod_def::GJ46xHWirM4::UG_LJMkGRCqw3OXnHyFrUA |
| Create a Company's Bank Account | POST | /bankAccounts | conn_mod_def::GJ46xG29l2I::0C5YX1ERTNi6F9MxOeqlVQ |
| Delete a Company’s Bank Account | DELETE | /bankAccounts({{bankAccountId}}) | conn_mod_def::GJ46xG20JBY::W38XymCaR2C2SG55khIZiA |
| Update a Company’s Bank Account | PATCH | /bankAccounts({{bankAccountId}}) | conn_mod_def::GJ46xHPXD4M::BLXJbGZCRs-RdLmqPf6Cxg |
Contacts
| Action | Method | Path | Action id |
|---|
| Get a Company's Contact | GET | /contacts({{contactId}}) | conn_mod_def::GJ46xc915TE::7hYpaMtKR2Wc1wNydg5q-w |
| Create a Company’s Contact | POST | /contacts | conn_mod_def::GJ46xP5Bpxg::CBEUCp_hSnS9Ulfddt-KNQ |
| Delete a Company's Contact | DELETE | /contacts({{contactId}}) | conn_mod_def::GJ46xaSjnoA::8Lc5kNR0Q1qdpzygYyDxwg |
| Update a Company's Contact | PATCH | /contacts({{contactId}}) | conn_mod_def::GJ46xmAuRCY::XwV1SC2vRLOov9XRNHciCw |
CountriesRegions
| Action | Method | Path | Action id |
|---|
| Get a Company's Country/Region (countriesRegions) | GET | /countriesRegions({{countryRegionId}}) | conn_mod_def::GJ46xvT8jWw::ju1HjSgeRIeK5WVQq8xHFw |
| Create a Company Country/Region (countriesRegions) | POST | /countriesRegions | conn_mod_def::GJ46xbjzKCU::CT0eFDgWQ0uaF85QepZHFw |
| Delete a Company's Country/Region | DELETE | /countriesRegions({{countryRegionId}}) | conn_mod_def::GJ46xxFKvb4::Z7vPW1_gRK-PfPJWTyTUow |
| Update a Company's Country/Region | PATCH | /countriesRegions({{countryRegionId}}) | conn_mod_def::GJ46xuHFG1U::zRJVGFPYQ9q4EIvculLtdA |
Currencies
| Action | Method | Path | Action id |
|---|
| Get a Company’s Currency | GET | /currencies({{currencyId}}) | conn_mod_def::GJ46x529j_k::cizyGFJsTvuzMTw_Ob9cNw |
| Create a Company Currency | POST | /currencies | conn_mod_def::GJ46xuVtFDg::ATDCeRogQaOX2p00CtzlHQ |
| Delete a Company's Currency | DELETE | /currencies({{currencyId}}) | conn_mod_def::GJ46xudiiaE::oxsGZcCaRP2wWpeiJ9Xufg |
| Update a Company's Currency | PATCH | /currencies({{currencyId}}) | conn_mod_def::GJ46x6CoGZI::34VmpSPdTmqrr8dCldhkJg |
Customers
| Action | Method | Path | Action id |
|---|
| Retrieve a Company's Customer | GET | /customers({{customerId}}) | conn_mod_def::GJ46yKyMN98::gaMm04pVS7KTMlDzJZTQ6w |
| Create a Customer (in a Company) | POST | /customers | conn_mod_def::GJ46x887hPo::u6AyjgGbSXOMB7FAJbXA6g |
| Delete a Company's Customer | DELETE | /customers({{customerId}}) | conn_mod_def::GJ46yGKBO_o::kwLXfN1_SuqutHAUN7DC1g |
| Update a Company's Customer | PATCH | /customers({{customerId}}) | conn_mod_def::GJ46yT5UbgU::sTKmsItHQWed3RblGJCqPQ |
CustomerPayments
| Action | Method | Path | Action id |
|---|
| Get a Company's Customer Payment | GET | /customerPayments({{customerPaymentId}}) | conn_mod_def::GJ46yeJl7W4::epcAOXlERv28_JrIaMYJyA |
| Create a Company Customer Payment | POST | /customerPayments({{customerPaymentId}}) | conn_mod_def::GJ46yemDDV8::47NC5P93SeCj05KBZ-tHbQ |
| Delete a Company's Customer Payment | DELETE | /customerPayments({{customerPaymentId}}) | conn_mod_def::GJ46yiH0Qdg::UW9pkRBGQyicNY6AmRTDfw |
| Update a Company's Customer Payment | PATCH | /customerPayments({{customerPaymentId}}) | conn_mod_def::GJ46yf3bqbs::6zBAHfqsRO27Ph73pTARnA |
CustomerPaymentJournals
| Action | Method | Path | Action id |
|---|
| Get a Company’s Customer Payment Journal | GET | /customerPaymentJournals({{customerPaymentJournalId}}) | conn_mod_def::GJ46yqxnez0::jhZMCYb9QMaQdI1CntyyTg |
| Create a Company's Customer Payment Journal | POST | /customerPaymentJournals | conn_mod_def::GJ46yfOUFWM::i8_2q27pTk-E7ds7LszM8g |
| Delete a Company's Customer Payment Journal | DELETE | /customerPaymentJournals({{customerPaymentJournalId}}) | conn_mod_def::GJ46yrA3Z2g::0OOvLWecR_mAUCwDmmkS9g |
| Update a Company's Customer Payment Journal | PATCH | /customerPaymentJournals({{customerPaymentJournalId}}) | conn_mod_def::GJ46yzIDZSM::UQayc9OxSuSsApAi_KPfcQ |
CustomerReturnReasons
| Action | Method | Path | Action id |
|---|
| Get a Company’s Customer Return Reason | GET | /customerReturnReasons({{customerReturnReasonId}}) | conn_mod_def::GJ46y7hXnOM::9cmXmxpmT1uKb2B1n9wmVA |
| Create a Company's Customer Return Reason | POST | /customerReturnReasons | conn_mod_def::GJ46yrlY7Y0::HIMEPGjGTeeLwNsi7c0jmQ |
| Delete a Company's Customer Return Reason | DELETE | /customerReturnReasons({{customerReturnReasonId}}) | conn_mod_def::GJ46yscb96M::ALuvzyxRSH2296MRNXG6ug |
| Update a Company's Customer Return Reason | PATCH | /customerReturnReasons({{customerReturnReasonId}}) | conn_mod_def::GJ46y8vZsK0::Shm-7g7-QJiC8MXTaOjt1w |
DimensionSetLines
| Action | Method | Path | Action id |
|---|
| Get a Dimension Set Line (for a Company Document) | GET | /salesOrders({{salesOrderId}})/dimensionSetLines({{dimensionSetLineId}}) | conn_mod_def::GJ46zWnXTIg::TRgl1k63Qqe1l6t5ZV2ZEQ |
| Create a Dimension Set Line for a Parent Entity | POST | /salesOrders({{parentId}})/dimensionSetLines({{dimensionSetLineId}}) | conn_mod_def::GJ46zMkHCII::_aoAijXOTkmDONtqY74u0Q |
| Delete a Dimension Set Line for a Parent Record | DELETE | /{{parentCollection}}({{parentId}})/dimensionSetLines({{dimensionSetLineId}}) | conn_mod_def::GJ46zN3Wekw::QJpMdTp5ScC7jyTAyDw4Eg |
| Update a Sales Order’s Dimension Set Line | PATCH | /salesOrders({{salesOrderId}})/dimensionSetLines({{dimensionSetLineId}}) | conn_mod_def::GJ46zX0eT5U::YD70wV-kTYeP2BQccEel6Q |
DisputeStatus
| Action | Method | Path | Action id |
|---|
| Get a Company’s Dispute Status | GET | /disputeStatus({{disputeStatusId}}) | conn_mod_def::GJ46zgzhRio::GwkpC40HSpmpd3I3_exn1A |
| Create a Company Dispute Status | POST | /disputeStatus({{disputeStatusId}}) | conn_mod_def::GJ46zXJyNJ8::yYy2FvC7T76YquatNsqrAw |
| Delete a Company’s Dispute Status | DELETE | /disputeStatus({{disputeStatusId}}) | conn_mod_def::GJ46zXiBmic::QgwaH07nS82ZCW0DhRlS5A |
| Update a Company’s Dispute Status | PATCH | /disputeStatus({{disputeStatusId}}) | conn_mod_def::GJ46zhftZ-c::6HoaajE-TOKURTtm_Fi4Jg |
DocumentAttachments
| Action | Method | Path | Action id |
|---|
| Get a Company’s Document Attachment | GET | /documentAttachments({{documentAttachmentId}}) | conn_mod_def::GJ46zf58OQw::385kDVoNQdKDWjCtPrRdlA |
| Create a Company Document Attachment | POST | /documentAttachments({{documentAttachmentId}}) | conn_mod_def::GJ46ziWKPk8::9l9zz487QZK7iaqmcQQ05g |
| Delete a Company’s Document Attachment | DELETE | /documentAttachments({{documentAttachmentId}}) | conn_mod_def::GJ46zf-_HwM::EAcOAYBVQgCIjdzpbfqCYQ |
| Update a Company’s Document Attachment | PATCH | /documentAttachments({{documentAttachmentId}}) | conn_mod_def::GJ46zqiM6RE::vRn_Whp8SwiCV4OBgQhTcA |
Employees
| Action | Method | Path | Action id |
|---|
| Get an Employee (by Company and Employee ID) | GET | /employees({{employeeId}}) | conn_mod_def::GJ46z4KcRpE::yqRT-xA7SOiR2O9k2sBJ2A |
| Create an Employee in a Company | POST | /employees | conn_mod_def::GJ46zqzL73M::nlB3_pBKRGem7cr4TPzN2w |
| Delete a Company's Employee | DELETE | /employees({{employeeId}}) | conn_mod_def::GJ46zruorXY::PAQgqh_FRFCFbyXUOtaenw |
| Update a Company's Employee | PATCH | /employees({{employeeId}}) | conn_mod_def::GJ46z4ixWNI::lkK44RcHSfGagO_QsMI9Jw |
FixedAssets
| Action | Method | Path | Action id |
|---|
| Get a Company’s Fixed Asset | GET | /fixedAssets({{fixedAssetId}}) | conn_mod_def::GJ460EeDp4g::0iS69rLvRM6UydjquItF3Q |
| Create a Company's Fixed Asset | POST | /fixedAssets({{fixedAssetId}}) | conn_mod_def::GJ46z7MbPZs::pIJpOIH9TfS7vQz5ziP4uw |
| Delete a Company's Fixed Asset | DELETE | /fixedAssets({{fixedAssetId}}) | conn_mod_def::GJ460E8qkvM::C-l_80EjQsOwov3Wol8p4Q |
| Update a Company's Fixed Asset | PATCH | /fixedAssets({{fixedAssetId}}) | conn_mod_def::GJ460ExFu58::8jfGufUVQ4yZig-QNc9UPA |
FixedAssetLocations
| Action | Method | Path | Action id |
|---|
| Get a Company’s Fixed Asset Location | GET | /fixedAssetLocations({{fixedAssetLocationId}}) | conn_mod_def::GJ460QcifOA::ULpbN7pITWOKhplDwlSC7A |
| Create a Company's Fixed Asset Location | POST | /fixedAssetLocations({{fixedAssetLocationId}}) | conn_mod_def::GJ460ECAX-Q::V5QZoSOhS0yxgFd6WVMsBw |
| Delete a Company's Fixed Asset Location | DELETE | /fixedAssetLocations({{fixedAssetLocationId}}) | conn_mod_def::GJ460IEj1jQ::ndhoTKV_Tl-EZMfR7zzuaA |
| Update a Company's Fixed Asset Location | PATCH | /fixedAssetLocations({{fixedAssetLocationId}}) | conn_mod_def::GJ460UYVuQI::Te-9kHStQyWJARsWZqR1QA |
ItemCategories
| Action | Method | Path | Action id |
|---|
| Get an Item Category (Company Scoped) | GET | /itemCategories({{itemCategoryId}}) | conn_mod_def::GJ460yeePj4::inQY2ZnbQkuTtEWnQPRYOw |
| Create an Item Category for a Company | POST | /itemCategories | conn_mod_def::GJ4603_H6F0::New1p1p2TgmN7WTUNSVjWg |
| Delete a Company's Item Category | DELETE | /itemCategories({{itemCategoryId}}) | conn_mod_def::GJ460yqEy-U::_rmHtT30RvaV1jsS7CfgTg |
1 more ItemCategories actions are available through search.
This lists 90 of 260 actions. For anything not here, call search_one_platform_actions with platform microsoft-dynamics-365-business-central. The full catalog is at https://www.withone.ai/knowledge/microsoft-dynamics-365-business-central.
When a call fails
The error comes from Microsoft Dynamics 365 Business Central, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.
Full catalog: https://www.withone.ai/knowledge/microsoft-dynamics-365-business-central
Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.
