# Associate Business Units

Associate Business Units allow [Associates](https://docs.commercetools.com/api/projects/business-units.md#associate) to interact with [Business Units](https://docs.commercetools.com/api/projects/business-units.md).

Associates can view, create, and update Business Units. The actions a given Associate is allowed to perform depends on the specific [roles and permissions](https://docs.commercetools.com/api/associates-overview.md) they hold within a Business Unit.

## Get BusinessUnit as Associate

### Get BusinessUnit by ID as Associate

See API endpoint definition [GET /\{projectKey}/as-associate/\{associateId}/business-units/\{id}](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%2F%7Bid%7D%3AGET).

### Get BusinessUnit by Key as Associate

See API endpoint definition [GET /\{projectKey}/as-associate/\{associateId}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3AGET).

## Query BusinessUnits as Associate

See API endpoint definition [GET /\{projectKey}/as-associate/\{associateId}/business-units](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%3AGET).

## Check if BusinessUnit exists as Associate

### Check if BusinessUnit exists by ID as Associate

See API endpoint definition [HEAD /\{projectKey}/as-associate/\{associateId}/business-units/\{id}](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%2F%7Bid%7D%3AHEAD).

### Check if BusinessUnit exists by Key as Associate

See API endpoint definition [HEAD /\{projectKey}/as-associate/\{associateId}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3AHEAD).

### Check if BusinessUnit exists by Query Predicate as Associate

See API endpoint definition [HEAD /\{projectKey}/as-associate/\{associateId}/business-units](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%3AHEAD).

## Create BusinessUnit as Associate

When creating a Division, the Associate must have the `AddChildUnits` [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission) in the parent unit. If the required [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission) is missing, an [AssociateMissingPermission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AAssociateMissingPermissionError) error is returned.

See API endpoint definition [POST /\{projectKey}/as-associate/\{associateId}/business-units](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%3APOST).

## Update BusinessUnit as Associate

The Associate must have sufficient [Permissions](https://docs.commercetools.com/api/projects/associate-roles.md#permission) to perform update actions:

- `UpdateAssociates` for [addAssociate](https://docs.commercetools.com/api/projects/business-units.md#add-associate), [setAssociates](https://docs.commercetools.com/api/projects/business-units.md#set-associates), [changeAssociate](https://docs.commercetools.com/api/projects/business-units.md#change-associate), and [removeAssociate](https://docs.commercetools.com/api/projects/business-units.md#remove-associate) update actions.
- `UpdateParentUnit` for the [changeParentUnit](https://docs.commercetools.com/api/projects/business-units.md#change-parent-unit) update action.
- `UpdateBusinessUnitDetails` for all other update actions.

If a required [Permission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3APermission) is missing, an [AssociateMissingPermission](https://docs.commercetools.com/urn?urn=ctp%3Aapi%3Atype%3AAssociateMissingPermissionError) error is returned.

For [addAssociate](https://docs.commercetools.com/api/projects/business-units.md#add-associate), [setAssociates](https://docs.commercetools.com/api/projects/business-units.md#set-associates), and [changeAssociate](https://docs.commercetools.com/api/projects/business-units.md#change-associate) update actions, the API only accepts [AssociateRoles](https://docs.commercetools.com/api/projects/associate-roles.md#associaterole) with the `buyerAssignable` property set to `true`.

### Update BusinessUnit by ID as Associate

See API endpoint definition [POST /\{projectKey}/as-associate/\{associateId}/business-units/\{id}](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%2F%7Bid%7D%3APOST).

### Update BusinessUnit by Key as Associate

See API endpoint definition [POST /\{projectKey}/as-associate/\{associateId}/business-units/key=\{key}](https://docs.commercetools.com/api/projects/associate-business-units.md?urn=ctp%3Aapi%3Aendpoint%3A%2F%7BprojectKey%7D%2Fas-associate%2F%7BassociateId%7D%2Fbusiness-units%2Fkey%3D%7Bkey%7D%3APOST).

## Related pages

- [Section overview page](https://docs.commercetools.com/api.md)
- [Previous page: Associate Quotes](https://docs.commercetools.com/api/projects/associate-quotes.md)
- [Next page: Associate Shopping Lists](https://docs.commercetools.com/api/projects/associate-shopping-lists.md)