---
canonical_url: "https://docs.composio.dev/toolkits/fleetio"
markdown_url: "https://docs.composio.dev/toolkits/fleetio.md"
product: "platform"
version: null
last_updated: null
---

# Fleetio

Fleetio is a fleet management platform for managing vehicles, equipment, maintenance, inspections, fuel, parts, purchasing, and operational workflows.

- **Category:** productivity
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 34
- **Triggers:** 0
- **Slug:** `FLEETIO`
- **Version:** 00000000_00

## Tools

### Archive Contact

**Slug:** `FLEETIO_ARCHIVE_CONTACT`

Archive one Fleetio contact by ID. This reversible action is preferred over permanent deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | integer | Yes | Positive Fleetio contact ID to archive. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Archive Vehicle

**Slug:** `FLEETIO_ARCHIVE_VEHICLE`

Archive one Fleetio vehicle by ID. This is reversible with Restore Vehicle and is preferred over permanent deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vehicle_id` | integer | Yes | Positive Fleetio vehicle ID to archive. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Change Issue State

**Slug:** `FLEETIO_CHANGE_ISSUE_STATE`

Close, 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `note` | string | No | Required non-empty explanation for close or resolve. Omit when reopening an issue. |
| `issue_id` | integer | Yes | Positive Fleetio issue ID to transition. |
| `transition` | string ("close" | "resolve" | "reopen") | Yes | Lifecycle transition to perform: close, resolve, or reopen. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Contact

**Slug:** `FLEETIO_CREATE_CONTACT`

Create a Fleetio contact with a required first name and optional common business identity fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Contact email address (up to 255 characters). |
| `employee` | boolean | No | Whether the contact is an employee. |
| `group_id` | integer | No | Positive Fleetio group ID to assign to the contact. |
| `job_title` | string | No | Contact job title (up to 255 characters). |
| `last_name` | string | No | Contact last name (up to 255 characters). |
| `first_name` | string | Yes | Contact first name (up to 255 characters). |
| `mobile_phone_number` | string | No | Contact mobile phone number (up to 255 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Fuel Entry

**Slug:** `FLEETIO_CREATE_FUEL_ENTRY`

Create a Fleetio fuel entry and its required meter reading for a vehicle. Supply volume in the vehicle's configured unit.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | ISO-8601 date and time when fueling occurred. |
| `liters` | number | No | Fuel amount in liters when the vehicle is configured to use liters. |
| `partial` | boolean | No | Whether this entry represents a partial fill-up. |
| `personal` | boolean | No | Whether this entry represents personal fuel use. |
| `reference` | string | No | Receipt number or other reference identifier. |
| `vendor_id` | integer | No | Positive Fleetio vendor ID. |
| `meter_void` | boolean | No | Whether to void the associated meter entry and bypass Fleetio's normal meter sequence validation. |
| `uk_gallons` | number | No | Fuel amount in UK gallons when the vehicle uses UK gallons. |
| `us_gallons` | number | Yes | Fuel amount in US gallons. Fleetio currently requires this field but ignores it when the vehicle uses another volume unit. |
| `vehicle_id` | integer | Yes | Positive Fleetio vehicle ID. |
| `meter_value` | number | Yes | Vehicle meter reading at fueling. Fleetio validates it against the vehicle's chronological meter history. |
| `fuel_type_id` | integer | No | Positive Fleetio fuel type ID. |
| `price_per_volume_unit` | number | No | Price per unit in the vehicle's configured fuel volume unit. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Issue

**Slug:** `FLEETIO_CREATE_ISSUE`

Report a Fleetio issue for a vehicle or equipment asset with required timing and summary plus optional priority, assignment, and labels.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `summary` | string | Yes | Short summary of the issue. |
| `asset_id` | integer | Yes | Positive Fleetio ID of the vehicle or equipment with the issue. |
| `due_date` | string | No | ISO-8601 date and time by which the issue should be resolved. |
| `label_ids` | array | No | Complete set of Fleetio label IDs to associate with the issue. |
| `asset_type` | string ("Vehicle" | "Equipment") | Yes | Type of asset with the issue. Equipment requires that Fleetio module. |
| `description` | string | No | Longer description of the issue. |
| `reported_at` | string | Yes | ISO-8601 date and time when the issue was reported. |
| `reported_by_id` | integer | No | Positive Fleetio contact ID of the person reporting the issue. |
| `issue_priority_id` | integer | No | Positive issue priority ID from Fleetio reference data. |
| `assigned_contact_ids` | array | No | Fleetio contact IDs to assign to the issue. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Meter Entry

**Slug:** `FLEETIO_CREATE_METER_ENTRY`

Record 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Vehicle

**Slug:** `FLEETIO_CREATE_VEHICLE`

Create a Fleetio vehicle with its required name, primary meter unit, status, and type, plus optional common identity and assignment fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vin` | string | No | Unique Vehicle Identification Number (up to 17 characters). |
| `make` | string | No | Vehicle manufacturer (up to 255 characters). |
| `name` | string | Yes | Unique name for the vehicle (up to 255 characters). |
| `year` | integer | No | Vehicle model year. |
| `model` | string | No | Vehicle model name (up to 255 characters). |
| `group_id` | integer | No | Positive Fleetio group ID to assign to the vehicle. |
| `fuel_type_id` | integer | No | Positive Fleetio fuel type ID to assign to the vehicle. |
| `license_plate` | string | No | Vehicle license plate number (up to 255 characters). |
| `vehicle_type_id` | integer | Yes | Positive vehicle type ID from LIST_REFERENCE_DATA. |
| `vehicle_status_id` | integer | Yes | Positive vehicle status ID from LIST_REFERENCE_DATA. |
| `primary_meter_unit` | string ("km" | "hr" | "mi") | Yes | Measurement unit for the vehicle's primary meter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Fuel Entry

**Slug:** `FLEETIO_DELETE_FUEL_ENTRY`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fuel_entry_id` | integer | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Issue

**Slug:** `FLEETIO_DELETE_ISSUE`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `issue_id` | integer | Yes | Exact positive Fleetio issue ID to permanently delete. Verify the ID before calling because this action is irreversible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Meter Entry

**Slug:** `FLEETIO_DELETE_METER_ENTRY`

Permanently 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meter_entry_id` | integer | Yes | Exact positive Fleetio meter entry ID to permanently delete. Verify the ID before calling because this action is irreversible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Contact

**Slug:** `FLEETIO_GET_CONTACT`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | integer | Yes | Positive Fleetio contact ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Issue

**Slug:** `FLEETIO_GET_ISSUE`

Retrieve full details for one Fleetio issue by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `issue_id` | integer | Yes | Positive Fleetio issue ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Service Entry

**Slug:** `FLEETIO_GET_SERVICE_ENTRY`

Retrieve one Fleetio service entry by ID, including its status, maintenance tasks, issues, meter data, and costs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `service_entry_id` | integer | Yes | Positive Fleetio service entry ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Vehicle

**Slug:** `FLEETIO_GET_VEHICLE`

Retrieve full current details for one Fleetio vehicle by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vehicle_id` | integer | Yes | Positive Fleetio vehicle ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Work Order

**Slug:** `FLEETIO_GET_WORK_ORDER`

Retrieve full details for one Fleetio work order by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `work_order_id` | integer | Yes | Positive Fleetio work order ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Account Context

**Slug:** `FLEETIO_LIST_ACCOUNTS`

Return Fleetio account identity, plan, state, and permission or feature context for the connected API key. Credential-like account tokens are always removed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `per_page` | integer | No | Maximum accounts to return on this page (2-100). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; pass it unchanged. |
| `filter_account_name_like` | string | No | Case-insensitive account-name match supported by Fleetio. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Contacts

**Slug:** `FLEETIO_LIST_CONTACTS`

Find Fleetio contacts using bounded cursor pagination and common identity or employment filters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort_by` | string ("id" | "group_id" | "created_at" | "updated_at") | No | Field used to order contacts. |
| `per_page` | integer | No | Maximum contacts to return on this page (2-100). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; pass it unchanged. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction. |
| `filter_email_eq` | string | No | Exact email address. |
| `filter_email_like` | string | No | Partial email address. |
| `filter_group_id_eq` | integer | No | Fleetio group ID. |
| `filter_last_name_like` | string | No | Partial last name. |
| `filter_employee_number_eq` | string | No | Exact employee number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Fuel Entries

**Slug:** `FLEETIO_LIST_FUEL_ENTRIES`

Find Fleetio fuel entries by vehicle, vendor, external ID, or date range using bounded cursor pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort_by` | string ("id" | "date" | "created_at" | "updated_at") | No | Field used to order fuel entries. |
| `per_page` | integer | No | Maximum fuel entries to return on this page (2-100). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; pass it unchanged. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction. |
| `filter_date_gte` | string | No | Earliest fuel-entry timestamp in ISO-8601 format. |
| `filter_date_lte` | string | No | Latest fuel-entry timestamp in ISO-8601 format. |
| `filter_vendor_id_eq` | integer | No | Exact Fleetio vendor ID. |
| `filter_vehicle_id_eq` | integer | No | Exact Fleetio vehicle ID. |
| `filter_external_id_eq` | string | No | Exact external-system fuel-entry ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Issues

**Slug:** `FLEETIO_LIST_ISSUES`

Find Fleetio issues by vehicle, state, issue number, assigned contact, due date, or reported date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `state` | string ("Open" | "Closed" | "Resolved") | No | Exact Fleetio issue state to return. |
| `sort_by` | string ("id" | "due_date" | "reported_at" | "resolved_at" | "created_at" | "updated_at") | No | Field used to order issues. |
| `per_page` | integer | No | Maximum issues to return on this page (2-100). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; pass it unchanged. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction. |
| `filter_number_eq` | string | No | Exact issue number, such as '#51'. |
| `assigned_contact_id` | integer | No | Return issues assigned to this exact Fleetio contact ID. |
| `filter_due_date_lte` | string | No | Latest due date in ISO-8601 date format. |
| `filter_vehicle_id_eq` | integer | No | Exact Fleetio vehicle ID. |
| `filter_reported_at_gte` | string | No | Earliest reported timestamp in ISO-8601 format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Meter Entries

**Slug:** `FLEETIO_LIST_METER_ENTRIES`

Find Fleetio primary or secondary meter readings by vehicle, meterable asset, category, or date range, ordered for chronology checks.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Reference Data

**Slug:** `FLEETIO_LIST_REFERENCE_DATA`

List one Fleetio reference collection used by vehicle, issue, work-order, service, fuel, vendor, grouping, and inspection workflows.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Service Entries

**Slug:** `FLEETIO_LIST_SERVICE_ENTRIES`

List Fleetio service entries by reference, status, or completion-date range, with sorting and cursor pagination.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Service Reminders

**Slug:** `FLEETIO_LIST_SERVICE_REMINDERS`

Find due, overdue, snoozed, or upcoming Fleetio service reminders by vehicle or service task.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort_by` | string ("id" | "next_due_at" | "created_at" | "updated_at") | No | Field used to order service reminders. |
| `per_page` | integer | No | Maximum service reminders to return on this page (2-100). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; pass it unchanged. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction. |
| `filter_status_eq` | string ("ok" | "overdue" | "due_soon" | "snoozed") | No | Exact service-reminder status. |
| `filter_vehicle_id_eq` | integer | No | Exact Fleetio vehicle ID. |
| `filter_service_task_id_eq` | integer | No | Exact Fleetio service-task ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Vehicles

**Slug:** `FLEETIO_LIST_VEHICLES`

Find active Fleetio vehicles by name, VIN, license plate, group, status, or type, with cursor pagination and configurable sorting.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort_by` | string ("id" | "name" | "created_at" | "updated_at") | No | Field used to order vehicles. |
| `per_page` | integer | No | Maximum vehicles to return on this page (2-100). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; pass it unchanged. |
| `filter_vin_eq` | string | No | Exact VIN. |
| `filter_name_eq` | string | No | Exact vehicle name. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction. |
| `filter_name_like` | string | No | Partial vehicle name. |
| `filter_group_id_eq` | integer | No | Fleetio group ID. |
| `filter_license_plate_eq` | string | No | Exact license plate. |
| `filter_vehicle_type_id_eq` | integer | No | Vehicle type ID. |
| `filter_vehicle_status_id_eq` | integer | No | Vehicle status ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Work Orders

**Slug:** `FLEETIO_LIST_WORK_ORDERS`

Find Fleetio work orders by vehicle, vendor, contact, number, status, or purchase order reference.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort_by` | string ("id" | "created_at" | "updated_at") | No | Field used to order work orders. |
| `per_page` | integer | No | Maximum work orders to return on this page (2-100). |
| `next_cursor` | string | No | Opaque cursor returned by the previous call; pass it unchanged. |
| `status_name` | string | No | Exact Fleetio work order status name, such as 'Completed'. |
| `sort_direction` | string ("asc" | "desc") | No | Sort direction. |
| `filter_number_eq` | string | No | Exact work order number, such as '#23'. |
| `filter_vendor_id_eq` | integer | No | Exact Fleetio vendor ID. |
| `filter_contact_id_eq` | integer | No | Exact Fleetio contact ID. |
| `filter_vehicle_id_eq` | integer | No | Exact Fleetio vehicle ID. |
| `filter_purchase_order_number_like` | string | No | Partial purchase order number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Contact

**Slug:** `FLEETIO_RESTORE_CONTACT`

Restore one archived Fleetio contact by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contact_id` | integer | Yes | Positive Fleetio contact ID to restore. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Restore Vehicle

**Slug:** `FLEETIO_RESTORE_VEHICLE`

Restore one archived Fleetio vehicle by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vehicle_id` | integer | Yes | Positive Fleetio vehicle ID to restore. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact

**Slug:** `FLEETIO_UPDATE_CONTACT`

Update selected business identity, communication, employment, or group fields on one Fleetio contact; omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | New email address. |
| `employee` | boolean | No | Whether the contact is an employee. |
| `group_id` | integer | No | Positive Fleetio group ID to assign. |
| `job_title` | string | No | New job title. |
| `last_name` | string | No | New last name. |
| `contact_id` | integer | Yes | Positive Fleetio contact ID to update. |
| `first_name` | string | No | New first name. |
| `mobile_phone_number` | string | No | New mobile phone number. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Fuel Entry

**Slug:** `FLEETIO_UPDATE_FUEL_ENTRY`

Correct selected timestamp, volume, meter, vendor, fuel type, price, flag, or reference fields on one Fleetio fuel entry; omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | New ISO-8601 date and time for the fueling event. |
| `liters` | number | No | New fuel volume in liters; used only for vehicles configured for liters. |
| `partial` | boolean | No | Whether the fuel entry represents a partial fill-up. |
| `personal` | boolean | No | Whether the fuel entry represents personal fuel use. |
| `reference` | string | No | New receipt number or other reference identifier. |
| `vendor_id` | integer | No | Positive Fleetio vendor ID to associate. |
| `meter_void` | boolean | No | Whether to mark the associated meter reading as void. |
| `uk_gallons` | number | No | New fuel volume in UK gallons; used only for vehicles configured for UK gallons. |
| `us_gallons` | number | No | New fuel volume in US gallons; used only for vehicles configured for US gallons. |
| `meter_value` | number | No | New associated vehicle meter reading. |
| `fuel_type_id` | integer | No | Positive Fleetio fuel type ID to associate. |
| `fuel_entry_id` | integer | Yes | Positive Fleetio fuel entry ID to update. |
| `price_per_volume_unit` | number | No | New price per the vehicle's configured fuel-volume unit. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Issue

**Slug:** `FLEETIO_UPDATE_ISSUE`

Update issue content, priority, due date, or assignments without changing the issue lifecycle state; omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `summary` | string | No | New short issue summary. |
| `due_date` | string | No | New ISO-8601 due date or date-time. |
| `issue_id` | integer | Yes | Positive Fleetio issue ID to update. |
| `label_ids` | array | No | Complete replacement set of label IDs; pass an empty list to remove all labels. |
| `description` | string | No | New detailed issue description. |
| `reported_by_id` | integer | No | Positive contact ID of the issue reporter. |
| `issue_priority_id` | integer | No | Positive Fleetio issue priority ID. |
| `assigned_contact_ids` | array | No | Complete replacement set of assigned contact IDs; pass an empty list to remove all assignments. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Meter Entry

**Slug:** `FLEETIO_UPDATE_METER_ENTRY`

Correct 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | No | Corrected ISO-8601 reading timestamp. Fleetio requires non-void meter values to increase chronologically and checks readings before and after this timestamp. |
| `void` | boolean | No | 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. |
| `value` | number | No | Corrected reading in the vehicle's configured meter unit. Fleetio validates non-void readings against the chronological meter sequence. |
| `meter_type` | string | No | Set to secondary only when correcting the entry to the secondary meter. |
| `meter_entry_id` | integer | Yes | Positive Fleetio meter entry ID to update. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Vehicle

**Slug:** `FLEETIO_UPDATE_VEHICLE`

Update selected identity, classification, or assignment fields on one Fleetio vehicle; omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `vin` | string | No | New unique Vehicle Identification Number, up to 17 characters. |
| `make` | string | No | New manufacturer name. |
| `name` | string | No | New unique vehicle name. |
| `year` | integer | No | New model year. |
| `model` | string | No | New model name. |
| `group_id` | integer | No | New group ID. |
| `vehicle_id` | integer | Yes | Vehicle ID to update. |
| `fuel_type_id` | integer | No | New fuel type ID. |
| `license_plate` | string | No | New license plate number. |
| `vehicle_type_id` | integer | No | New vehicle type ID. |
| `vehicle_status_id` | integer | No | New vehicle status ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Work Order

**Slug:** `FLEETIO_UPDATE_WORK_ORDER`

Update selected status, scheduling, assignment, reference, description, or issue fields on an existing Fleetio work order; omitted fields remain unchanged.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `issue_ids` | array | No | Complete set of positive Fleetio issue IDs associated with the work order. |
| `vendor_id` | integer | No | Positive Fleetio vendor ID to assign, or null to clear the vendor. |
| `contact_id` | integer | No | Positive Fleetio contact ID to assign, or null to clear the contact. |
| `started_at` | string | No | ISO-8601 date and time when the work order started. |
| `description` | string | No | New work order description. |
| `completed_at` | string | No | ISO-8601 date and time when the work order completed. |
| `scheduled_at` | string | No | ISO-8601 date and time when the work order is scheduled. |
| `work_order_id` | integer | Yes | Positive Fleetio work order ID to update. |
| `invoice_number` | string | No | Invoice number associated with the work order. |
| `work_order_status_id` | integer | No | New work order status ID from LIST_REFERENCE_DATA. |
| `expected_completed_at` | string | No | ISO-8601 date and time when the work order is expected to complete. |
| `purchase_order_number` | string | No | Purchase order number associated with the work order. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |