> ## Documentation Index
> Fetch the complete documentation index at: https://msprecapp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Map and manage organizations in MSP Recapp

> Map integration companies to canonical organizations in MSP Recapp so device coverage, billing, and reconciliation data lines up across all your tools.

Organizations are the central concept in Recapp. When you connect an integration — a PSA like HaloPSA or ConnectWise, an RMM like NinjaOne, or an endpoint tool like SentinelOne — it brings in its own list of "companies." Those companies won't automatically align with each other across tools, because each integration names clients differently. The Organizations page is where you create your canonical list of clients and draw the connections between each integration's companies and those clients. Once mapped, Recapp can cross-reference devices, licenses, and billing data per organization across every tool.

## Tabs

<Tabs>
  <Tab title="By Integration">
    The **By Integration** tab groups companies by the integration they come from. This is the best starting point when you are setting up Recapp for the first time, because you can work through each integration one by one and map or ignore every company it contains.

    Each integration's section shows which of its companies are already mapped to an organization, and which are still unlinked. You can map a company directly from this view without switching tabs.
  </Tab>

  <Tab title="All Mappings">
    The **All Mappings** tab shows a flat table of every organization you have created, along with the integration companies currently mapped to each one. The badge next to the tab label shows the total organization count.

    Use this tab to audit your mappings at a glance, navigate to an organization's detail page, or remove a mapping that is no longer accurate.
  </Tab>

  <Tab title="Unmapped">
    The **Unmapped** tab lists every integration company that has not yet been mapped to an organization or marked as ignored. The badge next to the tab label is red when there are unmapped companies remaining — the same count shown on the dashboard stat card.

    Unmapped companies are excluded from device coverage and billing reconciliation, so clearing this list is important before running reports.
  </Tab>

  <Tab title="Ignored">
    The **Ignored** tab shows companies you have explicitly excluded from Recapp. Common candidates are internal test companies, vendor accounts, or distributor entries that are not real managed clients.

    Ignored companies do not appear in device counts or reconciliation results. You can restore an ignored company at any time to bring it back into your mappings workflow.
  </Tab>
</Tabs>

## How to map an unmapped company

<Steps>
  <Step title="Open the Unmapped tab">
    Navigate to **Organizations** and click the **Unmapped** tab. You will see companies grouped by integration, each with a red badge showing the count.
  </Step>

  <Step title="Find the company to map">
    Locate the integration company you want to link. You can scroll through the list or use the search if your integration has many companies.
  </Step>

  <Step title="Select or create an organization">
    Click **Map** next to the company. In the dialog that appears, either select an existing organization from the dropdown, or choose to create a new one. If you are creating a new organization, enter a canonical name that you will recognize across all tools.
  </Step>

  <Step title="Confirm the mapping">
    Click **Save**. The company disappears from the Unmapped tab and appears under the chosen organization in All Mappings. The Unmapped Companies count on the dashboard decreases by one.
  </Step>
</Steps>

## How to create a new organization manually

You can create an organization without mapping an integration company at the same time. Click the **Add Organization** button in the top-right corner of the Organizations page. Enter the organization name and confirm. The new organization appears in the All Mappings tab immediately and is available to select when mapping integration companies later.

## Syncing companies

The **Sync Companies** dropdown button re-fetches the company list from your integrations so that any new clients added in your PSA or RMM appear in Recapp. You can sync all integrations at once, or pick a specific integration from the dropdown to sync only that source. A spinner on the button indicates a sync is in progress. The last sync time for each integration is shown next to its name in the dropdown.

<Note>
  The **Unmapped Companies** count on the dashboard reflects the number of companies currently in the Unmapped tab. Running a sync may increase this count if new companies have been added to an integration since the last sync.
</Note>