Skip to main content
Fleetio logo
  • Category: productivity
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 34
  • Triggers: 0
  • Slug: FLEETIO
  • Version: 20261101_00

Tools

Slug: FLEETIO_ARCHIVE_CONTACTArchive one Fleetio contact by ID. This reversible action is preferred over permanent deletion.

Input Parameters

integer
required
Positive Fleetio contact ID to archive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_ARCHIVE_VEHICLEArchive one Fleetio vehicle by ID. This is reversible with Restore Vehicle and is preferred over permanent deletion.

Input Parameters

integer
required
Positive Fleetio vehicle ID to archive.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_CHANGE_ISSUE_STATEClose, resolve, or reopen one Fleetio issue using the dedicated lifecycle endpoint for that transition. Closing and resolving require a note; reopening does not accept one.

Input Parameters

string
Required non-empty explanation for close or resolve. Omit when reopening an issue.
integer
required
Positive Fleetio issue ID to transition.
string ("close" | "resolve" | "reopen")
required
Lifecycle transition to perform: close, resolve, or reopen.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_CREATE_CONTACTCreate a Fleetio contact with a required first name and optional common business identity fields.

Input Parameters

string
Contact email address (up to 255 characters).
boolean
Whether the contact is an employee.
integer
Positive Fleetio group ID to assign to the contact.
string
Contact job title (up to 255 characters).
string
Contact last name (up to 255 characters).
string
required
Contact first name (up to 255 characters).
string
Contact mobile phone number (up to 255 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_CREATE_FUEL_ENTRYCreate a Fleetio fuel entry and its required meter reading for a vehicle. Supply volume in the vehicle’s configured unit.

Input Parameters

string
required
ISO-8601 date and time when fueling occurred.
number
Fuel amount in liters when the vehicle is configured to use liters.
boolean
Whether this entry represents a partial fill-up.
boolean
Whether this entry represents personal fuel use.
string
Receipt number or other reference identifier.
integer
Positive Fleetio vendor ID.
boolean
Whether to void the associated meter entry and bypass Fleetio’s normal meter sequence validation.
number
Fuel amount in UK gallons when the vehicle uses UK gallons.
number
required
Fuel amount in US gallons. Fleetio currently requires this field but ignores it when the vehicle uses another volume unit.
integer
required
Positive Fleetio vehicle ID.
number
required
Vehicle meter reading at fueling. Fleetio validates it against the vehicle’s chronological meter history.
integer
Positive Fleetio fuel type ID.
number
Price per unit in the vehicle’s configured fuel volume unit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_CREATE_ISSUEReport a Fleetio issue for a vehicle or equipment asset with required timing and summary plus optional priority, assignment, and labels.

Input Parameters

string
required
Short summary of the issue.
integer
required
Positive Fleetio ID of the vehicle or equipment with the issue.
string
ISO-8601 date and time by which the issue should be resolved.
array
Complete set of Fleetio label IDs to associate with the issue.
string ("Vehicle" | "Equipment")
required
Type of asset with the issue. Equipment requires that Fleetio module.
string
Longer description of the issue.
string
required
ISO-8601 date and time when the issue was reported.
integer
Positive Fleetio contact ID of the person reporting the issue.
integer
Positive issue priority ID from Fleetio reference data.
array
Fleetio contact IDs to assign to the issue.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_CREATE_METER_ENTRYRecord a primary or secondary Fleetio meter reading for a vehicle. Inspect the vehicle’s existing meter history first because Fleetio requires values to increase in chronological order and checks readings on both sides of the timestamp.

Input Parameters

string
required
ISO-8601 reading timestamp. Fleetio requires meter values to increase chronologically and validates this value against entries before and after this timestamp.
boolean
Whether to mark the entry void. Use true only intentionally; void entries do not participate normally in meter sequence validation.
number
required
Meter reading in the unit configured for the vehicle. The value must fit Fleetio’s chronological meter sequence for the supplied timestamp.
string
Set to secondary only for a secondary meter; omit for the primary meter. Readings remain hidden while the vehicle’s secondary meter is disabled.
integer
required
Positive Fleetio vehicle ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_CREATE_VEHICLECreate a Fleetio vehicle with its required name, primary meter unit, status, and type, plus optional common identity and assignment fields.

Input Parameters

string
Unique Vehicle Identification Number (up to 17 characters).
string
Vehicle manufacturer (up to 255 characters).
string
required
Unique name for the vehicle (up to 255 characters).
integer
Vehicle model year.
string
Vehicle model name (up to 255 characters).
integer
Positive Fleetio group ID to assign to the vehicle.
integer
Positive Fleetio fuel type ID to assign to the vehicle.
string
Vehicle license plate number (up to 255 characters).
integer
required
Positive vehicle type ID from LIST_REFERENCE_DATA.
integer
required
Positive vehicle status ID from LIST_REFERENCE_DATA.
string ("km" | "hr" | "mi")
required
Measurement unit for the vehicle’s primary meter.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_DELETE_FUEL_ENTRYPermanently delete one Fleetio fuel entry and its associated meter entry by exact fuel-entry ID. Both deletions are irreversible and can affect meter history, so use this only for a verified erroneous or disposable entry.

Input Parameters

integer
required
Exact positive Fleetio fuel entry ID to permanently delete. Fleetio also permanently deletes its associated meter entry. Verify the ID and both effects before calling because they are irreversible.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_DELETE_ISSUEPermanently delete one Fleetio issue by exact ID. This action is irreversible: use it only for a known disposable or erroneous issue after verifying the ID. Prefer issue state transitions for normal lifecycle handling.

Input Parameters

integer
required
Exact positive Fleetio issue ID to permanently delete. Verify the ID before calling because this action is irreversible.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_DELETE_METER_ENTRYPermanently delete one Fleetio meter entry by exact ID. This action is irreversible: use it only for a known erroneous or disposable reading after verifying the ID.

Input Parameters

integer
required
Exact positive Fleetio meter entry ID to permanently delete. Verify the ID before calling because this action is irreversible.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_GET_CONTACTRetrieve one Fleetio contact by ID for assignment, issue, or maintenance workflows. Returns purposeful business and employment details while omitting residential, license, user-access, and account-membership data.

Input Parameters

integer
required
Positive Fleetio contact ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_GET_ISSUERetrieve full details for one Fleetio issue by ID.

Input Parameters

integer
required
Positive Fleetio issue ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_GET_SERVICE_ENTRYRetrieve one Fleetio service entry by ID, including its status, maintenance tasks, issues, meter data, and costs.

Input Parameters

integer
required
Positive Fleetio service entry ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_GET_VEHICLERetrieve full current details for one Fleetio vehicle by ID.

Input Parameters

integer
required
Positive Fleetio vehicle ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_GET_WORK_ORDERRetrieve full details for one Fleetio work order by ID.

Input Parameters

integer
required
Positive Fleetio work order ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_ACCOUNTSReturn Fleetio account identity, plan, state, and permission or feature context for the connected API key. Credential-like account tokens are always removed.

Input Parameters

integer
Maximum accounts to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string
Case-insensitive account-name match supported by Fleetio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_CONTACTSFind Fleetio contacts using bounded cursor pagination and common identity or employment filters.

Input Parameters

string ("id" | "group_id" | "created_at" | "updated_at")
Field used to order contacts.
integer
Maximum contacts to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string ("asc" | "desc")
Sort direction.
string
Exact email address.
string
Partial email address.
integer
Fleetio group ID.
string
Partial last name.
string
Exact employee number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_FUEL_ENTRIESFind Fleetio fuel entries by vehicle, vendor, external ID, or date range using bounded cursor pagination.

Input Parameters

string ("id" | "date" | "created_at" | "updated_at")
Field used to order fuel entries.
integer
Maximum fuel entries to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string ("asc" | "desc")
Sort direction.
string
Earliest fuel-entry timestamp in ISO-8601 format.
string
Latest fuel-entry timestamp in ISO-8601 format.
integer
Exact Fleetio vendor ID.
integer
Exact Fleetio vehicle ID.
string
Exact external-system fuel-entry ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_ISSUESFind Fleetio issues by vehicle, state, issue number, assigned contact, due date, or reported date.

Input Parameters

string ("Open" | "Closed" | "Resolved")
Exact Fleetio issue state to return.
string ("id" | "due_date" | "reported_at" | "resolved_at" | "created_at" | "updated_at")
Field used to order issues.
integer
Maximum issues to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string ("asc" | "desc")
Sort direction.
string
Exact issue number, such as ‘#51’.
integer
Return issues assigned to this exact Fleetio contact ID.
string
Latest due date in ISO-8601 date format.
integer
Exact Fleetio vehicle ID.
string
Earliest reported timestamp in ISO-8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_METER_ENTRIESFind Fleetio primary or secondary meter readings by vehicle, meterable asset, category, or date range, ordered for chronology checks.

Input Parameters

string ("id" | "date" | "created_at" | "updated_at")
Field used to order meter entries; date orders readings chronologically.
string ("starting" | "ending" | "nightly" | "manual")
Exact Fleetio meter-entry category to return.
integer
Maximum meter entries to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string ("asc" | "desc")
Sort direction; descending returns the newest readings first.
string
Inclusive earliest meter-reading date or timestamp in ISO-8601 format.
string
Inclusive latest meter-reading date or timestamp in ISO-8601 format.
integer
Exact Fleetio vehicle ID.
integer
Exact associated Fleetio resource ID.
string ("FuelEntry" | "Issue" | "PurchaseDetail" | "ServiceEntry" | "SubmittedInspectionItem" | "VehicleAssignment" | "WorkOrder")
Type of resource associated with the meter entry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_REFERENCE_DATAList one Fleetio reference collection used by vehicle, issue, work-order, service, fuel, vendor, grouping, and inspection workflows.

Input Parameters

integer
Maximum reference records to return on this page (2-100).
string ("vehicle_statuses" | "vehicle_types" | "issue_priorities" | "work_order_statuses" | "service_tasks" | "fuel_types" | "vendors" | "groups" | "inspection_forms")
required
Reference collection to list; selects one fixed Fleetio endpoint.
string
Opaque cursor returned by the previous call for the same resource; pass it unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_SERVICE_ENTRIESList Fleetio service entries by reference, status, or completion-date range, with sorting and cursor pagination.

Input Parameters

string ("pending" | "completed")
Exact Fleetio service-entry status to return.
string ("id" | "completed_at" | "created_at" | "updated_at")
Field used to order service entries.
integer
Maximum service entries to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string ("asc" | "desc")
Sort direction.
string
Exact service reference.
string
Partial service reference.
string
Earliest completion timestamp in ISO-8601 format.
string
Latest completion timestamp in ISO-8601 format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_SERVICE_REMINDERSFind due, overdue, snoozed, or upcoming Fleetio service reminders by vehicle or service task.

Input Parameters

string ("id" | "next_due_at" | "created_at" | "updated_at")
Field used to order service reminders.
integer
Maximum service reminders to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string ("asc" | "desc")
Sort direction.
string ("ok" | "overdue" | "due_soon" | "snoozed")
Exact service-reminder status.
integer
Exact Fleetio vehicle ID.
integer
Exact Fleetio service-task ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_VEHICLESFind active Fleetio vehicles by name, VIN, license plate, group, status, or type, with cursor pagination and configurable sorting.

Input Parameters

string ("id" | "name" | "created_at" | "updated_at")
Field used to order vehicles.
integer
Maximum vehicles to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string
Exact VIN.
string
Exact vehicle name.
string ("asc" | "desc")
Sort direction.
string
Partial vehicle name.
integer
Fleetio group ID.
string
Exact license plate.
integer
Vehicle type ID.
integer
Vehicle status ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_LIST_WORK_ORDERSFind Fleetio work orders by vehicle, vendor, contact, number, status, or purchase order reference.

Input Parameters

string ("id" | "created_at" | "updated_at")
Field used to order work orders.
integer
Maximum work orders to return on this page (2-100).
string
Opaque cursor returned by the previous call; pass it unchanged.
string
Exact Fleetio work order status name, such as ‘Completed’.
string ("asc" | "desc")
Sort direction.
string
Exact work order number, such as ‘#23’.
integer
Exact Fleetio vendor ID.
integer
Exact Fleetio contact ID.
integer
Exact Fleetio vehicle ID.
string
Partial purchase order number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_RESTORE_CONTACTRestore one archived Fleetio contact by ID.

Input Parameters

integer
required
Positive Fleetio contact ID to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_RESTORE_VEHICLERestore one archived Fleetio vehicle by ID.

Input Parameters

integer
required
Positive Fleetio vehicle ID to restore.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_UPDATE_CONTACTUpdate selected business identity, communication, employment, or group fields on one Fleetio contact; omitted fields remain unchanged.

Input Parameters

string
New email address.
boolean
Whether the contact is an employee.
integer
Positive Fleetio group ID to assign.
string
New job title.
string
New last name.
integer
required
Positive Fleetio contact ID to update.
string
New first name.
string
New mobile phone number.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_UPDATE_FUEL_ENTRYCorrect selected timestamp, volume, meter, vendor, fuel type, price, flag, or reference fields on one Fleetio fuel entry; omitted fields remain unchanged.

Input Parameters

string
New ISO-8601 date and time for the fueling event.
number
New fuel volume in liters; used only for vehicles configured for liters.
boolean
Whether the fuel entry represents a partial fill-up.
boolean
Whether the fuel entry represents personal fuel use.
string
New receipt number or other reference identifier.
integer
Positive Fleetio vendor ID to associate.
boolean
Whether to mark the associated meter reading as void.
number
New fuel volume in UK gallons; used only for vehicles configured for UK gallons.
number
New fuel volume in US gallons; used only for vehicles configured for US gallons.
number
New associated vehicle meter reading.
integer
Positive Fleetio fuel type ID to associate.
integer
required
Positive Fleetio fuel entry ID to update.
number
New price per the vehicle’s configured fuel-volume unit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_UPDATE_ISSUEUpdate issue content, priority, due date, assignments, or labels without changing the issue lifecycle state; omitted fields remain unchanged.

Input Parameters

string
New short issue summary.
string
New ISO-8601 due date or date-time.
integer
required
Positive Fleetio issue ID to update.
array
Complete replacement set of label IDs; pass an empty list to remove all labels.
string
New detailed issue description.
integer
Positive contact ID of the issue reporter.
integer
Positive Fleetio issue priority ID.
array
Complete replacement set of assigned contact IDs; pass an empty list to remove all assignments.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_UPDATE_METER_ENTRYCorrect the timestamp, value, or void state of one Fleetio meter entry, or change its meter type from primary to secondary. This tool cannot change a secondary entry back to primary. Omitted fields remain unchanged; Fleetio returns no resource body after accepting the correction.

Input Parameters

string
Corrected ISO-8601 reading timestamp. Fleetio requires non-void meter values to increase chronologically and checks readings before and after this timestamp.
boolean
Set true to void an erroneous reading so it no longer participates normally in sequence validation; set false to restore a previously voided reading, which may expose meter conflicts.
number
Corrected reading in the vehicle’s configured meter unit. Fleetio validates non-void readings against the chronological meter sequence.
string
Set to secondary only when correcting the entry to the secondary meter.
integer
required
Positive Fleetio meter entry ID to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_UPDATE_VEHICLEUpdate selected identity, classification, or assignment fields on one Fleetio vehicle; omitted fields remain unchanged.

Input Parameters

string
New unique Vehicle Identification Number, up to 17 characters.
string
New manufacturer name.
string
New unique vehicle name.
integer
New model year.
string
New model name.
integer
New group ID.
integer
required
Vehicle ID to update.
integer
New fuel type ID.
string
New license plate number.
integer
New vehicle type ID.
integer
New vehicle status ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: FLEETIO_UPDATE_WORK_ORDERUpdate selected status, scheduling, assignment, reference, description, or issue fields on an existing Fleetio work order; omitted fields remain unchanged.

Input Parameters

array
Complete set of positive Fleetio issue IDs associated with the work order.
integer
Positive Fleetio vendor ID to assign, or null to clear the vendor.
integer
Positive Fleetio contact ID to assign, or null to clear the contact.
string
ISO-8601 date and time when the work order started.
string
New work order description.
string
ISO-8601 date and time when the work order completed.
string
ISO-8601 date and time when the work order is scheduled.
integer
required
Positive Fleetio work order ID to update.
string
Invoice number associated with the work order.
integer
New work order status ID from LIST_REFERENCE_DATA.
string
ISO-8601 date and time when the work order is expected to complete.
string
Purchase order number associated with the work order.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not