FwdMbl Public API
REST API for your FwdMbl data

Connect any system.
Keep FwdMbl in sync.

The FwdMbl Public API lets your ERP, warehouse and in-house systems send customers, items, routes and deliveries into FwdMbl, and read completed deliveries back with quantities, signatures and photos. Standard REST and JSON, keys you control in WebAdmin, and every call logged.

Public API200 OK
POST /pub/v1/customers/batch
X-Api-Key: ••••••••-••••

{ "DataItems": [
  { "CustomerNumber": "1001",
    "CustomerName": "Acme Foods" },
  { "CustomerNumber": "1002",
    "CustomerName": "Lakeside Market" }
] }
{ "IsError": false,
  "AddedCount": 1, "UpdatedCount": 1, "FailedCount": 0,
  "Results": [
    { "Key": "1001", "Status": "Added" },
    { "Key": "1002", "Status": "Updated" } ] }

Example request. Key and values are illustrative.

50+ resourcesMaster data, setup lists, assets and deliveries
500 per callBatch add or update, with results per record
None, View, EditAccess per area for every key

What your systems can do

Master data in

Customers, items, drivers, vehicles, sales reps, terms, warehouses and routes. Each is a standard REST resource you can create, read, update and delete.

Bulk sync in batches

Add or update up to 500 records per call, matched by number. Sending a record twice is safe, and one bad record never stops the rest.

Only what changed

Page through any list with a cursor, ask for records changed since your last sync, or fetch specific records by number.

Deliveries to the driver

Stage deliveries on drivers' routes with lines, pallets, boxes, labels and catch weights. Price and GPS come from the customer when you leave them out.

Completed deliveries back

Read completed deliveries with quantities, refusals, signatures and photos, and pick up from your last cursor to get only new completions.

Assets, lists and setup

Asset items, warranties, certifications and key lockers, plus item and customer authorization lists, classes and type lists.

Built for integration teams

Predictable REST endpoints, honest errors and an audit trail, so your developers spend their time on the integration, not on guesswork.

  • Keys you controlCreate keys in WebAdmin and give each one None, View or Edit for every area. Turn a key off if it leaks.
  • Every call loggedEndpoint, status, duration, key and IP in WebAdmin Public API Log and Usage. The key itself is never stored in the log.
  • Changes only what you sendUpdates leave missing fields alone, and deliveries a driver has started are locked against changes.
  • Clear, consistent errorsStandard HTTP status codes and one error shape, with every validation problem listed by field.
  • Safe to retryBatch calls add or update by number, so a retried sync never creates duplicates.
  • Docs and Postman readyThe reference, getting-started guide and a Postman collection are at developer.fwdmbl.com.

How it works

  1. We turn it onFwdMbl enables the Public API on your server at /pub/v1.
  2. Create a keyIn WebAdmin, create an API key and set None, View or Edit for each area it needs.
  3. Load your dataSend types and reference data first, then customers, items, drivers and routes. Use batch for bulk loads.
  4. Stage and collectSend deliveries to drivers' routes, then read completed deliveries, signatures and photos back.
API access is included with every FwdMbl systemUse it on its own or alongside Bridge Server, File Drop and the MCP AI Connector.