Skip to main content
DELETE
Delete Company
This endpoint permanently removes a company from the system. This is an irreversible operation that will delete the company record and may cascade to associated entities like stores, orders, and customer data.
Destructive Operation: This action cannot be undone. All company data, associated stores, and related information will be permanently deleted from the system.

Path Parameters

string
required
The unique identifier of the company to delete

Prerequisites

Before deleting a company, ensure:
action
Export any important company data, reports, or configurations that you may need later
action
Handle all associated stores - either delete them separately or transfer them to another company
action
Ensure all pending orders are completed or properly handled
action
Complete any outstanding payments, refunds, or billing processes
action
Notify customers about service discontinuation if applicable
action
Disconnect any third-party integrations and clean up API connections

Deletion Impact

deleted
Complete company profile including business information and settings
deleted
All associated address records
affected
All stores under this company may be affected (depending on system configuration)
affected
Admin and user accounts associated with this company will lose access
affected
Historical order data may be affected (check system retention policies)
affected
HubSpot connections and other CRM integrations will be severed

Response

boolean
Indicates whether the deletion operation was successful

Response Example

Error Scenarios

error
The specified company_id does not exist in the systemStatus Code: 404
error
Company has active stores that must be handled firstStatus Code: 409Solution: Delete or transfer all stores before deleting the company
error
Company has pending or processing ordersStatus Code: 409Solution: Wait for orders to complete or cancel them manually
error
User doesn’t have permission to delete companiesStatus Code: 403Solution: Ensure you have admin-level permissions

Alternative Approaches

alternative
Set the company’s active status to 0 instead of deletingBenefits: Preserves data while preventing new operations
alternative
Change company status to “Off Boarding” or “Churned”Benefits: Maintains audit trail and historical data
alternative
Export company data before deletion for archival purposesBenefits: Retains important business information for compliance
Best Practice: Consider using the Update Company endpoint to set active: 0 or change status to “Churned” instead of permanent deletion. This preserves valuable business data while effectively removing the company from active operations.
Compliance: Ensure deletion complies with data retention policies, GDPR requirements, and any regulatory obligations in your jurisdiction.