# Integration Configs

The Integration Configs page is the technical, per-record view of every integration connection your tenant has set up. Use it when you need to see exactly which providers are connected, when each one last synced, and to drill into the configuration of a single connection.

<figure><img src="/files/OHGm5Umm5QkIRsTpFJGR" alt=""><figcaption></figcaption></figure>

> **Permissions:** Viewing Integration Configs requires the `FleetAssistant.IntegrationConfigs` permission. Creating, editing, or deleting a config requires the matching `Create`, `Edit`, or `Delete` sub-permissions, which are typically granted to Administrators only.

## Integration Configs vs the Integrations marketplace

FleetFusion has two related pages, and it is worth keeping them straight:

| Page                           | URL                    | Purpose                                                                                                                                                                           |
| ------------------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Integrations** (marketplace) | `/integrations`        | A friendly directory of every provider FleetFusion supports, grouped into categories. Use it to browse what is available and start a new connection.                              |
| **Integration Configs**        | `/integration-configs` | A technical grid of the integration connections that already exist on your tenant, with one row per configured integration. Use it for diagnostics, status, and detailed editing. |

The marketplace is the recommended starting point - see [Integrations](/documentation/settings/integrations.md). When you need to look at the wire-level state of a connection, switch to Integration Configs.

## Opening Integration Configs

To open Integration Configs, navigate to `/integration-configs`, or click the **Integration Configs** entry under **Settings** in the sidebar.

## What the page shows

The page is a sortable, filterable grid (powered by Syncfusion) with one row per integration configuration. The columns are:

| Column           | Description                                                                                                                        |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Integration      | The provider name and logo (for example, DVLA, Trimble Maps, a fuel-card provider).                                                |
| Integration Name | The friendly name you gave this connection - useful when you have several connections to the same provider.                        |
| Active           | A green tick if the integration is enabled, a red cross if it is disabled.                                                         |
| Status           | A coloured pill showing the current connection state (for example, **Connected** in green, **Error** in red, **Pending** in blue). |
| API Base URI     | The base URL FleetFusion is calling for this integration.                                                                          |
| Error Message    | The most recent error message returned by the integration, if any.                                                                 |
| Last Sync        | The most recent successful synchronisation timestamp.                                                                              |
| Created          | When the configuration was first created.                                                                                          |
| Last Update      | When the configuration was last edited.                                                                                            |
| Actions          | Edit and Delete buttons (visible only to users with the matching permissions).                                                     |

The grid supports paging, sorting, filtering, resizing, and reordering. Click any column header to sort; use the column header filter icons to narrow the list.

## Header actions

* **+ New Integration Config** - opens the configuration dialog to add a connection. Visible only to users with the **Create** permission.
* **Cog icon (Configure Columns)** - opens the column chooser so you can show or hide columns to match your workflow.

## How to add an integration config

To add a new integration config:

1. Go to **Settings > Integration Configs**.
2. Click **+ New Integration Config**.
3. In the dialog, choose the **Integration** type and give the connection a name.
4. Enter the credentials and base URI required for the provider. The exact fields depend on which integration you select.
5. Mark the configuration as **Active** if it should start syncing immediately.
6. Click **Save**.

The new row appears in the grid and the **Status** column updates as FleetFusion attempts the first connection.

> **Tip:** For most providers, the easiest way to set up a connection is through the [Integrations](/documentation/settings/integrations.md) marketplace, which walks you through the required fields. Add a config directly here only when you already know the provider and the values to enter.

## Editing and removing a config

To edit a config, click the pencil icon on its row, or click the row to open the detail modal. Changes take effect on the next sync.

To remove a config, click the trash icon on its row and confirm. Removing the config stops further syncs but does not delete the records that were already imported.

> **Important:** Disabling or deleting a live integration may affect downstream features such as licence checks, fuel logs, telematics events, or video events. Confirm with an administrator before removing any active config.

## Related articles

* [Integrations](/documentation/settings/integrations.md)
* [Roles and permissions](/documentation/settings/roles-and-permissions.md)
* [Organisation settings](/documentation/settings/organisation-settings.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fleetfusion.ai/documentation/settings/integration-configs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.