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.
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 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:
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 |
Last modified on March 5, 2026