Delete Company | BigCommerce Developer Center

Deletes a Company account.

Independent vs. Dependent Companies Behavior

If your store is using Independent Companies behavior, deleting a Company account has no effect on its assigned customer group.

With Dependent Companies behavior, Company accounts and BigCommerce customer groups have a one-to-one relationship. Deleting a Company will also delete the corresponding customer group.

Deletes a Company account. ### Independent vs. Dependent Companies Behavior If your store is using Independent Companies behavior, deleting a Company account has no effect on its assigned customer group. With Dependent Companies behavior, Company accounts and BigCommerce customer groups have a one-to-one relationship. Deleting a Company will also delete the corresponding customer group.

Authentication

X-Auth-Tokenstring

Authentication header

Header	Argument	Description
`X-Auth-Token`	`access_token`	For more about API accounts that generate `access_token`s, see our Guide to API Accounts.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Auth-Token` | `access_token` | For more about API accounts that generate `access_token`s, see our [Guide to API Accounts](/developer/docs/overview/api-accounts). | ### Further reading For example requests and more information about authenticating BigCommerce APIs, see [Authentication and Example Requests](/developer/docs/overview/api-accounts#x-auth-token-header-example-requests). For more about BigCommerce OAuth scopes, see our [Guide to API Accounts](/developer/docs/overview/api-accounts#oauth-scopes). For a list of API status codes, see [API Status Codes](/developer/api-reference/rest/overview#rest-http-status-codes).

X-Store-Hashstring

Authentication header

Header	Argument	Description
`X-Store-Hash`	`store_hash`	The unique store hash associated with a BigCommerce store that has B2B Edition enabled.

### Authentication header | Header | Argument | Description | |:-------|:---------|:------------| | `X-Store-Hash` | `store_hash` | The unique store hash associated with a BigCommerce store that has B2B Edition enabled. |

Path parameters

companyIdstringRequired

Response

codeinteger

dataobject

metaobject

Errors

404

Not Found Error

1	import requests
2
3	url = "https://api-b2b.bigcommerce.com/api/v3/io/companies/companyId"
4
5	headers = {"X-Auth-Token": "<apiKey>"}
6
7	response = requests.delete(url, headers=headers)
8
9	print(response.json())

1	{
2	"code": 200,
3	"data": {},
4	"meta": {
5	"message": "SUCCESS"
6	}
7	}