Delete Company
Companies
Delete Company
This endpoint permanently deletes a company from the system. This is a destructive operation that will remove the company and potentially affect all associated stores, orders, and data. Use with extreme caution.
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
The unique identifier of the company to delete
Prerequisites
Before deleting a company, ensure:Pre-deletion Checklist
Pre-deletion Checklist
Export any important company data, reports, or configurations that you may need later
Handle all associated stores - either delete them separately or transfer them to another company
Ensure all pending orders are completed or properly handled
Complete any outstanding payments, refunds, or billing processes
Notify customers about service discontinuation if applicable
Disconnect any third-party integrations and clean up API connections
Deletion Impact
What Gets Deleted
What Gets Deleted
Complete company profile including business information and settings
All associated address records
All stores under this company may be affected (depending on system configuration)
Admin and user accounts associated with this company will lose access
Historical order data may be affected (check system retention policies)
HubSpot connections and other CRM integrations will be severed
Response
Indicates whether the deletion operation was successful
Response Example
Error Scenarios
Common Deletion Errors
Common Deletion Errors
The specified company_id does not exist in the systemStatus Code: 404
Company has active stores that must be handled firstStatus Code: 409Solution: Delete or transfer all stores before deleting the company
Company has pending or processing ordersStatus Code: 409Solution: Wait for orders to complete or cancel them manually
User doesn’t have permission to delete companiesStatus Code: 403Solution: Ensure you have admin-level permissions
Alternative Approaches
Alternatives to Deletion
Alternatives to Deletion
Set the company’s
active status to 0 instead of deletingBenefits: Preserves data while preventing new operationsChange company status to “Off Boarding” or “Churned”Benefits: Maintains audit trail and historical data
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.