Developers

Fleet Facts API

Connect your invoicing, phone or dispatch system. The REST API and webhooks are on the Team and Enterprise plans. An admin creates keys in Settings → Integrations → API keys; every call acts as that admin, with the same permissions as the app, and only sees your own account and your own territory.

Base URL /api/v1 · JSON · UTC timestamps

Auth Authorization: Bearer ffk_… · scopes read and write · 600 requests a minute per key

Machine-readable OpenAPI 3.1 description — import it into Postman, Insomnia or your code generator.

CRM

GET/companiesList companies
POST/companiesCreate a companywrite scopeRuns the duplicate check; a likely duplicate returns 409 unless `force: true`.
GET/companies/{id}One company
PATCH/companies/{id}Update a companywrite scope
GET/contactsList contacts
POST/contactsCreate or update a contactwrite scopeInclude `id` to update.
GET/activitiesList activities
POST/activitiesLog a call, email, text, visit or notewrite scopeOpen companies need nextAction and nextActionDue, as in the app.
GET/tasksThe TODAY board
POST/tasksCreate a taskwrite scope
POST/tasks/{id}/completeComplete a taskwrite scope
GET/opportunitiesList opportunities
GET/jobsList jobs (revenue)
POST/jobsRecord a job from your invoicing systemwrite scopeIdempotent on externalRef. The first job turns a prospect into a customer.
GET/vehiclesA company's vehicles
POST/vehiclesCreate or update a vehiclewrite scope

Fleet data

GET/territoryYour territory in numbers
GET/fleetsSearch fleets in your territoryFMCSA census fleets your account can see, with the same filters and territory rule as Explore. Pass at least one of st, zip, co, me, city, lat+lng+r, q or usdot. Paging stops at 10,000 rows.
GET/fleets/{dot}One carrier: equipment, inspections, violations404 outside your territory.
GET/violationsRoadside-inspection feed for your territory

Account

GET/referenceStages, industries, services, lead sources, team
GET/locationsYour locations: point, radius or drawn area, region

Webhooks

Subscribe in Settings → Integrations → Webhooks. Each delivery is a signed POST (X-FleetFix-Signature: sha256=…, HMAC of the raw body with your subscription secret), retried with backoff for up to five attempts.

company.createdcompany.updatedcompany.stage_changedcontact.createdactivity.loggedopportunity.updatedopportunity.wonopportunity.lostjob.createdtask.createdtask.completed

Questions or a missing endpoint? Contact us.

API · Fleet Facts