> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/integrations/it-assets-management/firstbase.md).

# Firstbase

Firstbase is a remote equipment management platform that helps organizations provision and track hardware for distributed teams. By connecting Firstbase to Harmony, you can bring your remote equipment data directly into your hardware catalog, giving you a unified view of assets alongside data from other sources like Jamf and Intune.

This integration is available in the Asset Management category of your Harmony Integrations settings.

### What you can do

* Sync device and asset records from Firstbase into your Harmony hardware catalog
* Manage multiple Firstbase connections if your organization uses more than one account
* View Firstbase assets alongside hardware from other integrated sources in a single inventory

### Prerequisites

Before setting up the integration, make sure you have:

* Access to the Harmony Integrations settings page
* API access enabled for your Firstbase organization
* A valid Firstbase API key (a Firstbase admin generates it in the Firstbase app under **Settings** > **API Access**, on the **API Credentials** tab; copy it right away, because it is shown only once)

### Connect Firstbase to Harmony

1. In Harmony, go to **Settings** and open the **Integrations** page.
2. Locate the **Asset Management** category and find **Firstbase** in the list of available integrations (or search for it by name).
3. Click the Firstbase card to open the connection form. If a Firstbase connection already exists, click **+ Create instance**.
4. Enter an **Instance name** for this connection (required).
5. Enter your Firstbase API key in the **API Key** field. No additional configuration or base URL is required.
6. Click **Connect**.

Once connected, Harmony will begin syncing your Firstbase device and asset records into the hardware catalog.

### Multiple instances

If your organization manages more than one Firstbase account, you can register multiple Firstbase connections. Repeat the steps above for each additional account and provide the corresponding API key for each one.

### Viewing synced assets

After the integration is active, assets synced from Firstbase are visible on the **Assets** page alongside records from other integrated providers. Only Firstbase items that have a serial number are synced. On each synced asset's page, the **Procurement** section shows the Firstbase status, asset condition, order date, and price. You can manage, search, and report on these assets the same way you would with any other hardware source in Harmony.

### Disconnecting Firstbase

To remove a Firstbase connection, navigate to the **Asset Management** section of your Integrations settings, click the **Firstbase** card, and click the delete (trash) icon next to the instance you want to remove.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.harmony.io/integrations/it-assets-management/firstbase.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
