https://github.com/soapyred/make-freightutils
Make.com custom app for FreightUtils — free freight tools API (CBM, LDM, ADR dangerous goods, HS codes, customs, reference data)
https://github.com/soapyred/make-freightutils
customs dangerous-goods freight integromat logistics make make-com shipping
Last synced: 3 days ago
JSON representation
Make.com custom app for FreightUtils — free freight tools API (CBM, LDM, ADR dangerous goods, HS codes, customs, reference data)
- Host: GitHub
- URL: https://github.com/soapyred/make-freightutils
- Owner: SoapyRED
- License: mit
- Created: 2026-04-24T21:08:33.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-30T00:31:06.000Z (about 1 month ago)
- Last Synced: 2026-04-30T02:22:54.659Z (about 1 month ago)
- Topics: customs, dangerous-goods, freight, integromat, logistics, make, make-com, shipping
- Language: JavaScript
- Homepage: https://www.freightutils.com
- Size: 39.1 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# make-freightutils
Make.com custom app for [FreightUtils](https://www.freightutils.com) — free freight tools API. **Currently private v0.2.2** on the EU2 Make zone. Public App Directory listing via the Technology Partner programme is queued for v0.3.0+.
## What's in this release
18 modules wrapping the FreightUtils REST API, matching the Zapier sibling's surface (v0.3.0):
**Actions (10)**
- Calculate CBM · LDM · Chargeable Weight · Consignment · Pallet Fitting · Convert Units
- Check ADR LQ/EQ Eligibility · Calculate ADR 1.1.3.6 Exemption · Calculate UK Import Duty
- **Calculate Shipment Summary** *(new in v0.2.0)* — composite covering CBM, chargeable weight, LDM, customs estimate, and DG flags for an entire shipment in one step
**Searches (8)**
- Find ADR Entry · HS Code · Incoterm · Airline · UN/LOCODE Location · ULD · Sea-Freight Container · Road-Freight Vehicle
Parity with `scripts/smoke-test.mjs` in the main monorepo minus `/api/health` and `/api/tools` — deliberately excluded as non-workflow operations.
## App coordinates
| | |
|---|---|
| Make zone | `eu2.make.com` |
| App name (generated) | `freightutils-gb5f0g` |
| Version | `1` (displayed as `1.0.0`) |
| Module type | Custom (SDK) app, private |
| Studio URL | |
## Install
The app is **private** — the owner (Soap) generates an invite URL from the Make Studio UI:
1. Open
2. Click **Invite** (top-right of the Studio page)
3. Copy the generated invitation link and paste to an invitee
The invitee visits the link while logged into their Make account; the app then appears in the module picker when they build a scenario.
Make does not expose invite URL generation through the SDK API at this time, so this step is UI-only — one click.
## Credentials
1. Generate a free FreightUtils API key (100 req/day) at . Pro tier (50,000 req/month, £19) via .
2. In Make: **Scenarios → Add → FreightUtils → any module → Add connection → FreightUtils API Key**. Paste the key.
3. Make validates the key by hitting `/api/health` with `X-API-Key` — green tick means auth works end to end.
## Worked scenario A — Airtable row → chargeable weight → Airtable
1. **Airtable → Watch Records** (trigger): new row in `Incoming Bookings` table with fields `length_cm`, `width_cm`, `height_cm`, `gross_weight_kg`.
2. **FreightUtils → Calculate Chargeable Weight** (action): map the four numeric fields.
3. **Airtable → Update a Record**: write `chargeable_weight_kg` and `volumetric_weight_kg` back to the source row.
## Worked scenario B — Webhook → HS code → UK duty → Slack
1. **Webhooks → Custom webhook** (trigger) receiving `{ "sku": "...", "origin": "BR", "value_gbp": 5000 }`.
2. **FreightUtils → Find HS Code** (search): `Query = {{webhook.sku}}` — returns an iterable list of candidate HS commodity codes.
3. **FreightUtils → Calculate UK Import Duty** (action): `Commodity Code = {{hsResults[1].commodity_code}}`, `Origin Country = {{webhook.origin}}`, `Customs Value = {{webhook.value_gbp}}`.
4. **Slack → Create a Message**: `HS {{commodity_code}} · Duty £{{duty_gbp}} · VAT £{{vat_gbp}} · Total £{{total_gbp}}`.
## Rate limits
| Tier | Limit |
|------|-------|
| Anonymous | 25 req/day per IP |
| Free key | 100 req/day |
| Pro key | 50,000 req/month (£19) |
Every response includes `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset` headers.
## Roadmap
- ~~**v0.2.0** — close 18-tool parity with `freightutils-mcp@2.0.0` / Zapier v0.3.0 by adding `shipmentSummary` composite~~ shipped
- **v0.3.0** — Technology Partner programme application for public App Directory listing
- **v0.4.0** — Dynamic RPCs (e.g. live HS chapter dropdown, airline-prefix lookup by carrier name)
- Later — webhooks / triggers if/when FreightUtils emits events
## Repo layout
```
make-freightutils/
├── app/
│ ├── app.json # app meta + base section
│ ├── connection.json # apiKey connection: parameters + validation api
│ └── modules/ # 18 modules — one JSON file each, all sections inline
│ ├── cbm.json
│ ├── ldm.json
│ ├── shipmentSummary.json # new in v0.2.0
│ └── … (18 total)
├── scripts/
│ └── push.mjs # one-shot orchestrator: create app + connection +
│ # modules, upload all sections via @makehq/cli
├── README.md
├── LICENSE.md
└── package.json # @makehq/cli devDependency only
```
Make's Apps SDK is API-driven (unlike Zapier's file-based model) — the authoritative app state lives in Make's registry, not in this repo. Treat the JSON files as source-of-truth definitions that the orchestrator deploys. To redeploy: `MAKE_API_KEY=... MAKE_ZONE=eu2.make.com node scripts/push.mjs` (note: will create a NEW app instance with suffix — delete the old one first, or adapt the script to update rather than create).
## Links
- FreightUtils:
- API docs:
- Pricing:
- Siblings: [n8n-nodes-freightutils](https://www.npmjs.com/package/n8n-nodes-freightutils) · [zapier-freightutils](https://github.com/SoapyRED/zapier-freightutils)
- Repo:
- Issues:
## Licence
MIT — see [LICENSE.md](LICENSE.md).
Built by [Marius Cristoiu](https://www.linkedin.com/in/marius-cristoiu-a853812a2/), ADR-certified freight transport planner.