Skip to main content

Fleetio

Fleetio is a modern fleet management platform that helps organizations track, manage, and optimize vehicle fleets and equipment. It centralizes vehicles, drivers, maintenance schedules, fuel entries, inspections, expenses, and parts inventory in one hub. Its REST API integrates fleet data — vehicle records, service entries, fuel transactions, fault codes, and inspection forms — with other business applications.

Fleetio icon

Power end-to-end data operations for your Fleetio API with Nexla. Our bi-directional Fleetio connector is purpose-built for Fleetio, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Fleetio or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Fleetio workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites

To authenticate Nexla with the Fleetio API, you will need two credentials from your Fleetio account: an API Key and your Account Token. Both are required for every API request made to Fleetio.

Obtain Your Fleetio API Key

Fleetio API keys are generated from within the Fleetio web application. Each API key is associated with a specific Fleetio user and inherits that user's permissions within the account.

  1. Sign in to your Fleetio account at https://secure.fleetio.com.

  2. Open the Account Menu (your user avatar or name in the top-right corner of the screen) and select Settings.

  3. In the Settings sidebar, click Manage API Keys.

  4. Click the + Add API Key button to create a new key.

  5. Enter a descriptive Label for the key (for example, Nexla Integration) to help identify its purpose.

  6. Select the API Version from the dropdown menu. Fleetio recommends using the latest available version.

  7. Click Save. The generated API key will appear under the Token column next to your chosen label. Copy this value for use in Nexla.

Important

Copy and store the API key immediately after it is generated. For security reasons, Fleetio does not display the full key value again after you navigate away from the Manage API Keys page. Treat this key as a password—do not share it publicly or commit it to source control.

Locate Your Fleetio Account Token

The Account Token is a unique identifier for your Fleetio organization account. It is required as a separate request header on every API call in addition to your API key.

  1. Sign in to your Fleetio account at https://secure.fleetio.com.

  2. Look at the URL in your browser's address bar on any Fleetio page. The URL follows the format https://secure.fleetio.com/{account_token}/....

  3. The path segment immediately following .com/ is your Account Token. For example, if the URL is https://secure.fleetio.com/abc123/dashboard, then abc123 is your Account Token.

Additional details about Fleetio API keys and authentication are available in the Fleetio Developer Portal Quick Start guide and the Fleetio API Keys Help Center article.

Authenticate

Credentials required

Authenticate using Fleetio API Key. Pass token in Authorization header as 'Token {api_key}' and account token in Account-Token header.

FieldRequiredSecretDescription
API KeyYesYesThe Fleetio API Key. Sent in the Authorization header as "Token {api_key}".
Account TokenYesYesThe Fleetio Account Token required on every API request in the Account-Token header.

Create a credential in Nexla

  1. After selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

Fleetio uses API Key authentication. Every API request to Fleetio must include two authentication values: an API key sent in the Authorization header (formatted as Token {your_api_key}) and an Account Token sent in the Account-Token header. Nexla handles both header values automatically once you supply them in the credential form.

  1. Enter your Fleetio API key in the API Key field. This key authenticates Nexla as a valid API consumer on behalf of your Fleetio user account. Nexla sends this value in the Authorization header as Token {api_key} on every request.

  2. Enter your Fleetio Account Token in the Account Token field. This token identifies the Fleetio organization account that all requests should target. Nexla sends this value in the Account-Token header on every request.

    Both the API Key and the Account Token are required. Requests that are missing either value will be rejected by the Fleetio API with an authentication error. Keep both values secure and do not share them in code repositories, chat messages, or other public locations.

  3. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation.

Use as a data source

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Fleetio connector tile, then select the credential that will be used to connect to the Fleetio instance, and click Next; or, create a new Fleetio credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Fleetio endpoints. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below. Click on an endpoint to see more information about it and how to configure your data source for this endpoint.

List Submitted Inspection Forms

This endpoint returns a paginated list of all submitted inspection forms in your Fleetio account. Use this endpoint when you need to analyze completed vehicle inspections, track defect reports, or audit inspection compliance across your fleet.

  • This endpoint uses page-based pagination to retrieve all submitted inspection forms. Nexla automatically handles pagination, fetching up to 100 records per page until all records have been retrieved.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all submitted inspection forms accessible to your Fleetio credential.
  • The response data is extracted from the submitted_inspection_forms array in each API response.

For additional details about the submitted inspection forms endpoint, refer to the Fleetio Submitted Inspection Forms API documentation.

List Issues

This endpoint returns a paginated list of all issues reported in your fleet management system. Use this endpoint to track vehicle defects, reported problems, and issue resolution status across your fleet.

  • This endpoint uses cursor-based pagination. Nexla automatically handles pagination by following the next_cursor value in each response until all records have been retrieved, fetching up to 100 records per page.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all issues accessible to your Fleetio credential.
  • The response data is extracted from the records array in each API response.

For additional details about the issues endpoint, refer to the Fleetio Issues API documentation.

List Service Entries

This endpoint returns a paginated list of all service entries recorded for vehicles in your fleet. Use this endpoint to analyze maintenance history, track repair costs, or report on service activity across your fleet.

  • This endpoint uses cursor-based pagination. Nexla automatically handles pagination by following the next_cursor value in each response until all records have been retrieved, fetching up to 100 records per page.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all service entries accessible to your Fleetio credential.
  • The response data is extracted from the records array in each API response.

For additional details about the service entries endpoint, refer to the Fleetio Service Entries API documentation.

List Contacts

This endpoint returns a paginated list of all contacts in your Fleetio account, including drivers, vendors, and other people associated with your fleet. Use this endpoint to sync contact and driver information with external HR, payroll, or directory systems.

  • This endpoint uses cursor-based pagination. Nexla automatically handles pagination by following the next_cursor value in each response until all records have been retrieved, fetching up to 100 records per page.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all contacts accessible to your Fleetio credential.
  • The response data is extracted from the records array in each API response.

For additional details about the contacts endpoint, refer to the Fleetio Contacts API documentation.

List Parts

This endpoint returns a paginated list of all parts in your Fleetio parts inventory. Use this endpoint to monitor inventory levels, track part usage, or synchronize parts data with procurement or accounting systems.

  • This endpoint uses cursor-based pagination. Nexla automatically handles pagination by following the next_cursor value in each response until all records have been retrieved, fetching up to 100 records per page.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all parts accessible to your Fleetio credential.
  • The response data is extracted from the records array in each API response.

For additional details about the parts endpoint, refer to the Fleetio Parts API documentation.

List Purchase Orders

This endpoint returns a paginated list of all purchase orders in your Fleetio account. Use this endpoint to track fleet-related procurement activity, reconcile purchase orders with accounting records, or report on fleet spending.

  • This endpoint uses cursor-based pagination. Nexla automatically handles pagination by following the next_cursor value in each response until all records have been retrieved, fetching up to 100 records per page.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all purchase orders accessible to your Fleetio credential.
  • The response data is extracted from the records array in each API response.

For additional details about the purchase orders endpoint, refer to the Fleetio Purchase Orders API documentation.

List Vehicle Assignments

This endpoint returns a paginated list of all vehicle assignments in your fleet, linking vehicles to the contacts or drivers they are assigned to. Use this endpoint to report on vehicle utilization, track driver-vehicle pairings, or audit assignment history.

  • This endpoint uses cursor-based pagination. Nexla automatically handles pagination by following the next_cursor value in each response until all records have been retrieved, fetching up to 100 records per page.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all vehicle assignments accessible to your Fleetio credential.
  • The response data is extracted from the records array in each API response.

For additional details about the vehicle assignments endpoint, refer to the Fleetio Vehicle Assignments API documentation.

List All Vehicles

This endpoint returns a complete list of all vehicles in your Fleetio fleet account. Vehicles are the core asset in Fleetio, representing any vehicle or unit of equipment managed in the system. Use this endpoint to synchronize vehicle records with external systems, build fleet inventory reports, or populate downstream analytics.

  • This endpoint retrieves all vehicles in a single API call without pagination. The response data is extracted from the vehicles array in the API response.
  • No additional parameters are required beyond selecting this endpoint template. The endpoint automatically retrieves all vehicles accessible to your Fleetio credential.

For additional details about the vehicles endpoint, refer to the Fleetio API Getting Started guide.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration

Fleetio data sources can also be manually configured to ingest data from any valid Fleetio API endpoint, including endpoints not covered by the pre-built templates, chained API calls, or custom request parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

All Fleetio API endpoints use the base URL https://secure.fleetio.com/api/—for example, the vehicles endpoint is https://secure.fleetio.com/api/v1/vehicles. Most v2 endpoints (e.g., /api/v2/service_entries) return records inside a records array, so set the path to data to $.records[*]; v1 endpoints typically use an endpoint-specific array, such as $.vehicles[*] for /api/v1/vehicles or $.submitted_inspection_forms[*] for submitted inspection forms. You do not need to add the Authorization or Account-Token headers to the Request Headers field—these are automatically included by Nexla based on your Fleetio credential configuration.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Fleetio data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.

Use as a destination

Click the + icon on the Nexset that will be sent to the Fleetio destination, and select the Send to Destination option from the menu. Select the Fleetio connector from the list of available destination connectors, then select the credential that will be used to connect to the Fleetio account, and click Next; or, create a new Fleetio credential for use in this flow.

Endpoint templates

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Fleetio endpoints. Select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

Create Acquisition

Creates a new vehicle acquisition record in Fleetio with financing details such as lease, loan, or purchase information. Use this endpoint to automatically populate Fleetio with vehicle acquisition data sourced from dealership systems, financial platforms, or procurement tools.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/acquisitions. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data is mapped to the correct Fleetio acquisition fields before activating the destination.

For details about the required and optional fields for acquisition records, refer to the Fleetio Acquisitions API documentation.

Update Acquisition

Updates an existing vehicle acquisition record in Fleetio with new financing details or corrected information. Use this endpoint when acquisition data has changed in an external system and you need to keep Fleetio records in sync.

  • This endpoint sends a PATCH request to https://secure.fleetio.com/api/v1/acquisitions/{'{id}'}, where {id} is the ID of the acquisition record to update.
  • Enter the ID of the acquisition to update in the Acquisition ID field. This value identifies which existing Fleetio acquisition record will be modified.

    • The Acquisition ID can be sourced from a prior Nexla data flow that ingested acquisition data from Fleetio, or from another system that stores Fleetio acquisition IDs.

For details about updatable acquisition fields, refer to the Fleetio Acquisitions API documentation.

Create Expense Entry

Creates a new expense entry for a vehicle in Fleetio. Use this endpoint to automatically log vehicle-related expenses—such as tolls, fines, or miscellaneous costs—sourced from expense management systems, credit card feeds, or accounting platforms.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/expense_entries. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the vehicle ID and expense details required by the Fleetio API.

For details about the required and optional fields for expense entries, refer to the Fleetio Expense Entries API documentation.

Update Expense Entry

Updates an existing expense entry in Fleetio with corrected or additional information. Use this endpoint when expense data needs to be updated after initial entry.

  • This endpoint sends a PATCH request to https://secure.fleetio.com/api/v1/expense_entries/{'{id}'}, where {id} is the ID of the expense entry to update.
  • Enter the ID of the expense entry to update in the Id field. This is a required parameter that identifies which existing Fleetio expense record will be modified.

For details about updatable expense entry fields, refer to the Fleetio Expense Entries API documentation.

Create Fault

Creates a new fault record for a vehicle in Fleetio with code, status, and occurrence details. Use this endpoint to automatically log diagnostic trouble codes (DTCs) or other fault events sourced from telematics systems, OBD readers, or vehicle monitoring platforms.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/faults. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the required vehicle ID, fault code, and other relevant fault details.

For details about the required and optional fields for fault records, refer to the Fleetio Faults API documentation.

Update Fault

Updates an existing fault record in Fleetio with new code, status, occurrence details, or other information. Use this endpoint to keep fault records current as diagnostic data changes in telematics or maintenance systems.

  • This endpoint sends a PATCH request to https://secure.fleetio.com/api/v1/faults/{'{id}'}, where {id} is the ID of the fault record to update.
  • Configure the following optional parameters to provide additional context for the fault update:

    • Id (required): The ID of the fault record to update in Fleetio.
    • Vehicle ID: The ID of the vehicle associated with the fault.
    • Fault Code: The diagnostic fault code identifier (e.g., a DTC code such as P0300).
    • Count: The number of times this fault has occurred.
    • Description: A detailed description of the fault.
    • External ID: An external identifier for the fault from another system, useful for cross-referencing records.
    • Last Occurred At: The timestamp when the fault was last detected.
    • Name: The name or title of the fault.
    • Status: The current status of the fault (e.g., active, resolved).
    • Source: The source system or device that reported the fault.

For details about updatable fault fields and accepted values, refer to the Fleetio Faults API documentation.

Create Vehicle

Creates a new vehicle record in Fleetio with details such as make, model, VIN, license plate, and financial information. Use this endpoint to automatically provision new vehicles in Fleetio when they are added to your fleet through dealership integrations, procurement systems, or other data sources.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/vehicles. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes required vehicle fields such as name, make, model, and VIN as needed by your Fleetio account configuration.

For details about the required and optional fields for vehicle records, refer to the Fleetio Create a Vehicle API reference.

Create a New Fuel Entry

Creates a new fuel entry in Fleetio representing a fuel transaction, including vendor and odometer information. Use this endpoint to automatically log fuel transactions sourced from fuel card integrations, pump data feeds, or fleet card management systems.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/fuel_entries. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the vehicle ID, fuel quantity, and other required fuel entry fields.

For details about the required and optional fields for fuel entries, refer to the Fleetio Fuel Entries API documentation.

Record an Odometer or Engine-Hour Reading

Records an odometer or engine-hour meter reading for a vehicle in Fleetio. Use this endpoint to automatically submit meter readings sourced from telematics devices, GPS trackers, or manual data collection systems, keeping vehicle mileage and usage data current in Fleetio.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/meter_entries. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the vehicle ID, meter value, and the date/time of the reading.

For details about meter entry fields and the bulk API, refer to the Fleetio Bulk API reference.

Create a Service/Maintenance Entry

Creates a new service or maintenance entry for a vehicle in Fleetio. Use this endpoint to automatically log completed maintenance work sourced from shop management systems, work order platforms, or external maintenance tracking tools.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v2/service_entries. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the vehicle ID, service description, and completion date as required by the Fleetio API.

For details about the required and optional fields for service entries, refer to the Fleetio Create Service Entry API reference.

Archive / Delete a Vehicle Record

Archives or deletes a vehicle record in Fleetio. Use this endpoint to automatically remove vehicles from your active fleet when they are decommissioned, sold, or otherwise removed from service, based on data from asset management or disposal systems.

Important

Deleting a vehicle record in Fleetio is a destructive action. Verify that the correct Vehicle ID is being passed before activating this destination. This action may not be reversible.

Create a New Part Record

Creates a new part record in the Fleetio parts inventory. Use this endpoint to automatically add new parts to Fleetio when they are procured or received, sourcing data from purchase orders, supplier integrations, or inventory management systems.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/parts. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the required part fields such as name, part number, and quantity.

For details about the required and optional fields for parts, refer to the Fleetio Parts API documentation.

Create a New Purchase Order

Creates a new purchase order in Fleetio. Use this endpoint to automatically generate purchase orders in Fleetio from data sourced from procurement systems, accounting platforms, or supplier portals.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/purchase_orders. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the required purchase order fields as defined by the Fleetio API.

For details about the required and optional fields for purchase orders, refer to the Fleetio Purchase Orders API documentation.

Create a New Contact

Creates a new contact in Fleetio, such as a driver, vendor, or other person associated with your fleet. Use this endpoint to automatically provision contacts in Fleetio from HR systems, onboarding platforms, or directory services.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v2/contacts. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the required contact fields such as first name, last name, and any other fields required by your Fleetio account configuration.

For details about the required and optional fields for contacts, refer to the Fleetio Contacts API documentation.

Create a New Issue / Defect Report

Creates a new issue or defect report in Fleetio. Use this endpoint to automatically log vehicle issues sourced from driver inspection apps, telematics alerts, or external defect tracking systems.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v2/issues. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the required issue fields such as vehicle ID, description, and reported date.

For details about the required and optional fields for issues, refer to the Fleetio Issues API documentation.

Update an Existing Fuel Entry

Updates an existing fuel entry in Fleetio with corrected or supplemental information. Use this endpoint when fuel transaction data needs to be amended after initial creation.

For details about updatable fuel entry fields, refer to the Fleetio Fuel Entries API documentation.

Update an Existing Service Entry

Updates an existing service or maintenance entry in Fleetio. Use this endpoint to amend service records when additional work details, cost corrections, or completion information becomes available after initial entry.

For details about updatable service entry fields, refer to the Fleetio Create/Update Service Entry API reference.

Create a New Vehicle Assignment

Creates a new vehicle assignment in Fleetio, associating a contact or driver with a specific vehicle. Use this endpoint to automatically assign vehicles to drivers sourced from scheduling systems, dispatch platforms, or HR systems.

  • This endpoint sends a POST request to https://secure.fleetio.com/api/v1/vehicle_assignments. Data from the Nexset is sent as a JSON body in the request.
  • No additional template parameters are required. Ensure that the Nexset data includes the required vehicle ID and contact ID fields.

For details about the required and optional fields for vehicle assignments, refer to the Fleetio Vehicle Assignments API documentation.

Update an Existing Part Record

Updates an existing part record in the Fleetio parts inventory. Use this endpoint to synchronize part quantities, pricing, or other attributes when inventory data changes in procurement or warehouse management systems.

For details about updatable part fields, refer to the Fleetio Parts API documentation.

Update an Existing Purchase Order

Updates an existing purchase order in Fleetio with new or corrected information. Use this endpoint to keep Fleetio purchase orders synchronized with changes in procurement or accounting systems.

For details about updatable purchase order fields, refer to the Fleetio Purchase Orders API documentation.

Update an Existing Contact

Updates an existing contact record in Fleetio. Use this endpoint to keep driver or vendor information current when contact details change in HR systems, directories, or onboarding platforms.

For details about updatable contact fields, refer to the Fleetio Contacts API documentation.

Update / Resolve an Existing Issue

Updates or resolves an existing issue in Fleetio. Use this endpoint to automatically close or update issue records when they have been addressed in an external maintenance management system, work order platform, or dispatch tool.

For details about updatable issue fields and resolution statuses, refer to the Fleetio Issues API documentation.

Manual configuration

Fleetio destinations can also be manually configured to send data to any valid Fleetio API endpoint. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, data format, endpoint URL, request headers, attribute exclusions, record batching, and response webhooks. Using manual configuration, you can also configure Nexla to automatically send the response received from the Fleetio API after each call to a new Nexla webhook data source.

Fleetio's REST API accepts JSON for all write operations. All Fleetio API endpoints use the base URL https://secure.fleetio.com/api/; for update or delete operations, include the ID of the record to be modified at the end of the URL (e.g., https://secure.fleetio.com/api/v1/vehicles/12345). You do not need to include the Authorization or Account-Token headers in the Request Headers field—these are automatically included by Nexla based on your Fleetio credential configuration.

Save & activate

Once all endpoint settings have been configured, click the Done button in the upper right corner of the screen to save and create the destination. To begin sending data to Fleetio, open the destination resource menu, and select Activate.

The Nexset data will not be sent to Fleetio until the destination is activated. Destinations can be activated immediately or at a later time, providing full control over data movement.