See what the Acumatica integration can do →
This article catalogs the Acumatica endpoints the iPaaS.com integration calls, grouped by entity. It is a reference for understanding which parts of your Acumatica instance the integration touches — useful for firewall and API-access configuration, for checking whether an Acumatica change affects the integration, and for troubleshooting. Every call is governed by your Acumatica instance's user permissions, licensing, and request limits.
API Overview
The integration uses the Acumatica Contract-Based REST API (Acumatica product help, accessed 2026-06-26). All endpoint paths below are written against a single environment-agnostic base address:
[Base URL] = https://{Instance Identifier}/entity/Default/{Version}{Instance Identifier} is your Acumatica instance address, taken from the API Url setting.
{Version} is the Acumatica endpoint contract version, taken from the Version setting (for example,
22.200.001).
Because each Acumatica environment is different, your base address and version may differ from another subscriber's; the integration uses whatever you configured. Records are read on a recurring poll and on demand via Manual Sync; records written from iPaaS.com are sent when an Outbound Data Flow trigger fires or a Manual Sync runs. Acumatica does not push changes to iPaaS.com — there are no webhooks.
Table of Contents
Customer Endpoints
Stock Item Endpoints
Tax and Tax Zone Endpoints
Sales Order Endpoints
Warehouse Endpoints
Shipment Endpoints
Inventory Endpoints
Authorization Endpoint
Customer Endpoints
Customers move in both directions: captured from Acumatica into iPaaS.com and written from iPaaS.com into Acumatica. Customer addresses are carried as children of the Customer.
Get a Customer by Id (GET)
[Base URL]/Customer/{Id}?$expand=ShippingContact/Address,BillingContact/Address,PrimaryContact/Address,MainContact/AddressFind a Customer by email (GET)
Used to link an incoming record to an existing Acumatica Customer. The integration searches each contact type in turn — billing, shipping, primary, then main — until a match is found.
[Base URL]/Customer?$expand={ContactType}&$filter={ContactType}/Email eq '{EmailAddress}'{ContactType} is one of BillingContact, ShippingContact, PrimaryContact, or MainContact.
Get changed Customers (GET, polling)
[Base URL]/Customer?$filter=LastModifiedDateTime gt datetimeoffset'{LastModifiedDate}'Create or update a Customer (PUT)
Acumatica's Contract-Based REST API uses PUT as an upsert: the integration matches on the customer identifier and updates the existing record when one is found, or creates a new one when it is not.
[Base URL]/Customer?$expand=ShippingContact,BillingContact,PrimaryContact,MainContact,MainContact/Address
On update, the same call is sent with an added &$filter=CustomerID eq '{CustomerID}' to target the existing record.
Stock Item Endpoints
Stock Items are captured from Acumatica into iPaaS.com only (the integration does not write Stock Items back). Per-warehouse availability is captured through $expand=WarehouseDetails.
Get a Stock Item by SKU (GET)
[Base URL]/StockItem/{SKU}?$expand=WarehouseDetailsGet a Stock Item by Id (GET)
[Base URL]/StockItem/{Id}?$expand=WarehouseDetailsGet changed Stock Items (GET, polling)
[Base URL]/StockItem?$filter=LastModified gt datetimeoffset'{LastModifiedDate}'Tax and Tax Zone Endpoints
Reference lookups read from Acumatica into iPaaS.com so that a Sales Order written into Acumatica carries tax data that matches how your instance is configured.
Get all Taxes (GET)
[Base URL]/Tax
Get all Tax Zones (GET)
[Base URL]/TaxZone
Sales Order Endpoints
Sales Orders are written from iPaaS.com into Acumatica. A Sales Order's line items, addresses, tax details, and payments are written as children of the order through the $expand parameter.
Find a Sales Order by order number (GET)
[Base URL]/SalesOrder?$filter=OrderNbr eq '{OrderNbr}'&$expand=shipmentsGet a Sales Order by Id (GET)
[Base URL]/SalesOrder/{Id}?$expand=Details,TaxDetails,BillToAddress,ShipToAddress,BillToContact,ShipToContact,PaymentsCreate or update a Sales Order (PUT)
An upsert: creates the order when it does not yet exist and updates it when it does.
[Base URL]/SalesOrder?$expand=Details,TaxDetails,BillToAddress,ShipToAddress,BillToContact,ShipToContact
Warehouse Endpoints
Warehouses are captured from Acumatica into iPaaS.com only.
Get a Warehouse by Id (GET)
[Base URL]/Warehouse/{Id}Get all Warehouses (GET)
[Base URL]/Warehouse
Shipment Endpoints
Shipment endpoints carry tracking data, which moves in both directions and is also handled as a child of the Sales Order.
Find a Shipment by shipment number (GET)
[Base URL]/Shipment?$filter=ShipmentNbr eq '{ShipmentNbr}'&$expand=Orders,PackagesGet changed Shipments (GET, polling)
[Base URL]/Shipment?$expand=Orders,Packages&$top={Limit}&$skip={Offset}&$filter=LastModifiedDateTime ge datetimeoffset'{LastModifiedDate}'Locate Shipments for an order (GET)
[Base URL]/Shipment?$filter={OrderFilter}&$expand=Details,Orders,PackagesCreate or update a Shipment (PUT)
[Base URL]/Shipment?$expand=Packages,Packages/PackageContents
Inventory Endpoints
Record an Inventory Issue (PUT)
Writes an inventory issue into Acumatica to record an inventory adjustment.
[Base URL]/InventoryIssue
Authorization Endpoint
The integration authenticates with OAuth 2.0 against your Acumatica instance. Tokens are obtained and refreshed automatically using the credentials in your subscription settings. The OAuth endpoints are at the instance root (not under the entity base address):
[Auth Base URL] = https://{Instance Identifier}[Auth Base URL]/identity/connect/authorize (GET — authorization-code flow)
[Auth Base URL]/identity/connect/token (POST — token issue and refresh)Which flow is used depends on the Grant Type setting (authorization_code for the browser-based flow, password for the resource-owner flow). See the Acumatica Connections and Settings article for how these values are supplied.
Records Not Supported
The integration is scoped to the entities above. Some other Acumatica record types are not supported and should not be expected to transfer — in particular, Acumatica invoices and purchase orders are out of scope, and non-stock items are not captured. For the full list of boundaries, see the Acumatica Known Limitations article.
Related Documents
Acumatica Installation Instructions: how to install and configure the integration, including the Acumatica credential and OAuth setup.
Acumatica Connections and Settings: the connection and subscription settings, including the API Url, Version, and authentication values referenced above.
Acumatica Error Messages: the errors the integration can surface, their causes, and how to resolve them.
Acumatica Mapping Documentation: the per-entity mapping articles describing how fields move between Acumatica and iPaaS.com.
Endpoints reflect the integration's use of the Acumatica Contract-Based REST API (Acumatica product help, https://help.acumatica.com, accessed 2026-06-26). Path availability, request limits, OAuth configuration, and the contract version are governed by your own Acumatica instance.
