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
/companiesList companies/companiesCreate a companywrite scopeRuns the duplicate check; a likely duplicate returns 409 unless `force: true`./companies/{id}One company/companies/{id}Update a companywrite scope/contactsList contacts/contactsCreate or update a contactwrite scopeInclude `id` to update./activitiesList activities/activitiesLog a call, email, text, visit or notewrite scopeOpen companies need nextAction and nextActionDue, as in the app./tasksThe TODAY board/tasksCreate a taskwrite scope/tasks/{id}/completeComplete a taskwrite scope/opportunitiesList opportunities/jobsList jobs (revenue)/jobsRecord a job from your invoicing systemwrite scopeIdempotent on externalRef. The first job turns a prospect into a customer./vehiclesA company's vehicles/vehiclesCreate or update a vehiclewrite scopeFleet data
/territoryYour territory in numbers/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./fleets/{dot}One carrier: equipment, inspections, violations404 outside your territory./violationsRoadside-inspection feed for your territoryAccount
/referenceStages, industries, services, lead sources, team/locationsYour locations: point, radius or drawn area, regionWebhooks
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.completedQuestions or a missing endpoint? Contact us.