> ## 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 Overview

> Create, retrieve, update, and delete business entities within an account on the HoopAI Platform using the Businesses REST API.

The HoopAI Platform Businesses API lets you manage business entity records scoped to an account. Attach a business profile — including name, address, phone, email, and website — to a location, then retrieve, update, or remove it as your data changes. This is distinct from your company record; a business here is a client-facing entity living inside an account.

## Base URL

```
https://services.leadconnectorhq.com
```

## Authentication

All requests must carry a signed Bearer token and the API version header.

```bash theme={null}
Authorization: Bearer <access_token>
Version: 2021-07-28
```

Use an Account-level access token or a Private Integration token scoped to the target account. See [OAuth 2.0](/api-reference/oauth/overview) for token generation details.

## OAuth scopes

| Scope                 | Access                                      |
| --------------------- | ------------------------------------------- |
| `businesses.readonly` | Read business records and listings          |
| `businesses.write`    | Create, update, and delete business records |

## Quick start

List all businesses for a given account:

```bash theme={null}
curl -X GET "https://services.leadconnectorhq.com/businesses/?locationId={locationId}" \
  -H "Authorization: Bearer <access_token>" \
  -H "Version: 2021-07-28" \
  -H "Accept: application/json"
```

## Endpoints

| Method   | Path                       | Description                       |
| -------- | -------------------------- | --------------------------------- |
| `GET`    | `/businesses/`             | Get all businesses for a location |
| `POST`   | `/businesses/`             | Create a new business             |
| `GET`    | `/businesses/{businessId}` | Get a business by ID              |
| `PUT`    | `/businesses/{businessId}` | Update a business                 |
| `DELETE` | `/businesses/{businessId}` | Delete a business                 |

## Related

* [OAuth 2.0 overview](/api-reference/oauth/overview) — Generate and refresh access tokens
* [Accounts API](/api-reference/locations/overview) — Manage the accounts that own business records
* [Contacts API](/api-reference/contacts/overview) — Associate contacts with business entities