Businesses Overview

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

OAuth 2.0 overview — Generate and refresh access tokens
Accounts API — Manage the accounts that own business records
Contacts API — Associate contacts with business entities

Contacts

Opportunities

Businesses

Custom Fields

Objects

Associations

Workflows

Base URL

Authentication

OAuth scopes

Quick start

Endpoints

​Base URL

​Authentication

​OAuth scopes

​Quick start

​Endpoints

​Related

Base URL

Authentication

OAuth scopes

Quick start

Endpoints

Related