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

# Businesses

> Create and manage business (company) records in the HoopAI Platform and link them to individual contacts for account-based organisation.

<div style={{position: "relative", paddingTop: "56.25%", marginBottom: "1.5rem"}}>
  <iframe src="https://player.mediadelivery.net/embed/622351/29db09c1-34b1-4fb6-a1cd-6590216897aa?preload=true" loading="lazy" style={{border: "none", position: "absolute", top: 0, height: "100%", width: "100%"}} allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture" allowFullScreen={true} />
</div>

The Businesses feature lets you create company-level records and associate individual contacts with those companies. This gives your team a structured, account-based view of your relationships — you can track deals, notes, and activities at the company level rather than only at the individual contact level.

Businesses are their own object in the HoopAI Platform and can be linked to contacts, opportunities, and custom objects through associations.

***

## Accessing businesses

Navigate to **Contacts** and click the **Businesses** tab at the top of the section. The businesses list shows all company records with their associated contact counts and key details.

***

## Creating a business

<Steps>
  <Step title="Open the Businesses tab">
    Go to **Contacts > Businesses** and click **+ Create Business** (or the **+ Add** button, depending on your account view).
  </Step>

  <Step title="Enter business details">
    Fill in the company information:

    * **Business name** — the company's legal or trading name (required)
    * **Phone number** — main business phone
    * **Email address** — main business email
    * **Website** — company URL
    * **Address** — street, city, state, zip, and country
    * **Description** — free-text notes about the company
  </Step>

  <Step title="Save the business">
    Click **Save** to create the business record. It appears immediately in the Businesses list.
  </Step>
</Steps>

<Frame caption="Creating a new business record">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/5j372da1_YvJVoEe/images/contacts-customize-add-contact.png?fit=max&auto=format&n=5j372da1_YvJVoEe&q=85&s=37b664acb0ca465f111f2ac54f04b15c" alt="Creating a new business record in the Businesses tab" width="1183" height="392" data-path="images/contacts-customize-add-contact.png" />
</Frame>

***

## Linking contacts to a business

After creating a business record, associate individual contacts with it so you can view all people at that company in one place.

### From the business record

<Steps>
  <Step title="Open the business record">
    In **Contacts > Businesses**, click the business name to open its record.
  </Step>

  <Step title="Add a contact">
    In the **Contacts** section of the business record, click **+ Add Contact**.
  </Step>

  <Step title="Search and select">
    Type the contact's name or email to search. Select the matching contact from the dropdown to create the association.
  </Step>
</Steps>

### From a contact record

<Steps>
  <Step title="Open the contact record">
    Navigate to **Contacts > Smart Lists** and click the contact's name.
  </Step>

  <Step title="Go to General Info">
    Click the **General Info** tab in the left panel. Locate the **Business Name** field.
  </Step>

  <Step title="Enter or select the business">
    Type the business name. If it already exists in your Businesses list, select it from the suggestions. If it does not exist, type the name and save — a new business record may be created automatically, or you can create it separately in the Businesses tab.
  </Step>
</Steps>

<Tip>
  Linking contacts to a business through the General Info tab is the fastest way to associate many contacts at once when doing a data import — include a "Business Name" column in your CSV and map it during the import field-mapping step.
</Tip>

***

## Viewing a business record

A business record consolidates everything related to that company in one view:

* **Overview panel** — name, phone, email, website, address, and description
* **Contacts** — all individual contacts linked to this business
* **Opportunities** — all open and closed deals associated with the business
* **Notes** — company-level notes visible across the team
* **Activity** — a timeline of interactions linked to the business or any of its contacts
* **Custom fields** — business-level custom fields configured in Settings

<Frame caption="A business record overview showing contacts and details">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/ISC7y4WirTQDUcmj/images/contacts-restore-confirm.png?fit=max&auto=format&n=ISC7y4WirTQDUcmj&q=85&s=1ae1f07ba029796c38a2b9e15422e60b" alt="Business record overview" width="1590" height="472" data-path="images/contacts-restore-confirm.png" />
</Frame>

***

## Editing a business record

<Steps>
  <Step title="Open the business record">
    Click the business name in the **Businesses** list.
  </Step>

  <Step title="Edit fields">
    Click the pencil icon next to any field to edit it, or click directly into editable fields. Changes save automatically when you click outside the field.
  </Step>
</Steps>

***

## Removing a contact from a business

<Steps>
  <Step title="Open the business record">
    Navigate to **Contacts > Businesses** and click the business name.
  </Step>

  <Step title="Remove the association">
    In the **Contacts** section, click the **X** or the trash icon next to the contact you want to remove. This removes the link between the contact and the business but does not delete the contact record.
  </Step>
</Steps>

***

## Deleting a business

In the **Businesses** list, click the **three-dot icon** next to the business and select **Delete**. Confirm the deletion when prompted.

<Warning>
  Deleting a business record removes the company and its associated data, but does not delete the individual contact records linked to it. Contacts remain in the system; they simply lose the business association.
</Warning>

***

## Business custom fields

<Frame caption="Custom fields settings for business records">
  <img src="https://mintcdn.com/hoopai-84ec0cdc/5j372da1_YvJVoEe/images/contacts-customize-fields.png?fit=max&auto=format&n=5j372da1_YvJVoEe&q=85&s=2f091cc8dac147d06520b58a5016b5d3" alt="Custom fields configuration for businesses" width="585" height="386" data-path="images/contacts-customize-fields.png" />
</Frame>

You can create custom fields specifically for business records to capture company-specific attributes such as industry, company size, annual revenue, or account tier.

Go to **Settings > Custom Fields**, select the **Companies** object tab, and create fields using the same process as contact custom fields. Business custom fields appear in the business record and can be used as filter conditions in smart lists that target business objects.

***

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Can a contact be linked to more than one business?">
    A contact's primary business name field holds one company. However, through the Associations feature, you can link a contact to multiple business records using custom association labels.
  </Accordion>

  <Accordion title="Can I import businesses from a CSV?">
    Yes. During the contact import wizard, select both Contacts and Businesses as import objects. Map the business fields during the field-mapping step. New business records are created automatically for company names that do not already exist.
  </Accordion>

  <Accordion title="Can I filter contacts by their business in smart lists?">
    Yes. Use **Advanced Filters** in Smart Lists and filter by the **Business Name** field to find all contacts associated with a specific company.
  </Accordion>

  <Accordion title="Are opportunities linked at the business level or contact level?">
    Opportunities can be linked to both a contact and a business simultaneously. When you associate an opportunity with a contact who belongs to a business, the opportunity appears on both the contact record and the business record.
  </Accordion>
</AccordionGroup>
