/**
* GoHighLevel Businesses Tools
* Tools for managing businesses (multi-business support)
*/
import { GHLApiClient } from '../clients/ghl-api-client.js';
export class BusinessesTools {
constructor(private ghlClient: GHLApiClient) {}
getToolDefinitions() {
return [
{
name: 'get_businesses',
description: 'Get all businesses for a location. Businesses represent different entities within a sub-account.',
inputSchema: {
type: 'object',
properties: {
locationId: {
type: 'string',
description: 'Location ID (uses default if not provided)'
}
}
}
},
{
name: 'get_business',
description: 'Get a specific business by ID',
inputSchema: {
type: 'object',
properties: {
businessId: {
type: 'string',
description: 'The business ID to retrieve'
},
locationId: {
type: 'string',
description: 'Location ID (uses default if not provided)'
}
},
required: ['businessId']
}
},
{
name: 'create_business',
description: 'Create a new business for a location',
inputSchema: {
type: 'object',
properties: {
locationId: {
type: 'string',
description: 'Location ID (uses default if not provided)'
},
name: {
type: 'string',
description: 'Business name'
},
phone: {
type: 'string',
description: 'Business phone number'
},
email: {
type: 'string',
description: 'Business email address'
},
website: {
type: 'string',
description: 'Business website URL'
},
address: {
type: 'string',
description: 'Business street address'
},
city: {
type: 'string',
description: 'Business city'
},
state: {
type: 'string',
description: 'Business state'
},
postalCode: {
type: 'string',
description: 'Business postal/zip code'
},
country: {
type: 'string',
description: 'Business country'
},
description: {
type: 'string',
description: 'Business description'
},
logoUrl: {
type: 'string',
description: 'URL to business logo image'
}
},
required: ['name']
}
},
{
name: 'update_business',
description: 'Update an existing business',
inputSchema: {
type: 'object',
properties: {
businessId: {
type: 'string',
description: 'The business ID to update'
},
locationId: {
type: 'string',
description: 'Location ID (uses default if not provided)'
},
name: {
type: 'string',
description: 'Business name'
},
phone: {
type: 'string',
description: 'Business phone number'
},
email: {
type: 'string',
description: 'Business email address'
},
website: {
type: 'string',
description: 'Business website URL'
},
address: {
type: 'string',
description: 'Business street address'
},
city: {
type: 'string',
description: 'Business city'
},
state: {
type: 'string',
description: 'Business state'
},
postalCode: {
type: 'string',
description: 'Business postal/zip code'
},
country: {
type: 'string',
description: 'Business country'
},
description: {
type: 'string',
description: 'Business description'
},
logoUrl: {
type: 'string',
description: 'URL to business logo image'
}
},
required: ['businessId']
}
},
{
name: 'delete_business',
description: 'Delete a business from a location',
inputSchema: {
type: 'object',
properties: {
businessId: {
type: 'string',
description: 'The business ID to delete'
},
locationId: {
type: 'string',
description: 'Location ID (uses default if not provided)'
}
},
required: ['businessId']
}
}
];
}
async handleToolCall(toolName: string, args: Record<string, unknown>): Promise<unknown> {
const config = this.ghlClient.getConfig();
const locationId = (args.locationId as string) || config.locationId;
switch (toolName) {
case 'get_businesses': {
return this.ghlClient.makeRequest('GET', `/businesses/?locationId=${locationId}`);
}
case 'get_business': {
const businessId = args.businessId as string;
return this.ghlClient.makeRequest('GET', `/businesses/${businessId}?locationId=${locationId}`);
}
case 'create_business': {
const body: Record<string, unknown> = {
locationId,
name: args.name
};
const optionalFields = ['phone', 'email', 'website', 'address', 'city', 'state', 'postalCode', 'country', 'description', 'logoUrl'];
optionalFields.forEach(field => {
if (args[field]) body[field] = args[field];
});
return this.ghlClient.makeRequest('POST', `/businesses/`, body);
}
case 'update_business': {
const businessId = args.businessId as string;
const body: Record<string, unknown> = { locationId };
const optionalFields = ['name', 'phone', 'email', 'website', 'address', 'city', 'state', 'postalCode', 'country', 'description', 'logoUrl'];
optionalFields.forEach(field => {
if (args[field]) body[field] = args[field];
});
return this.ghlClient.makeRequest('PUT', `/businesses/${businessId}`, body);
}
case 'delete_business': {
const businessId = args.businessId as string;
return this.ghlClient.makeRequest('DELETE', `/businesses/${businessId}?locationId=${locationId}`);
}
default:
throw new Error(`Unknown tool: ${toolName}`);
}
}
}
