# Entity Connections

If you want to share business objects across entities, you have to set up a connection between the source entity and the target entity first.

**Note**: Entity connections are available only if you have the <a href="https://knowledgecenter.zuora.com/Billing/Tenant_Management/Multi-entity" target="_blank">Multi-entity</a> feature enabled. If you want to have access to the Multi-entity feature, submit a request at <a href=“http://support.zuora.com/” target=“_blank”>Zuora Global Support</a>. 


## Multi-entity: List connections

 - [GET /v1/entity-connections](https://developer.zuora.com/v1-api-reference/older-api/entity-connections/get_entityconnections.md): Retrieves information about certain connections for a specified entity. You can specify the entity to retrieve in the Zuora-Entity-Ids request header.

You can retrieve:
 - Inbound connections
 - Outbound connections
 - Both inbound and outbound connections

### User Access Permission
You can make the call as any entity user.

## Multi-entity: Initiate a connection request

 - [POST /v1/entity-connections](https://developer.zuora.com/v1-api-reference/older-api/entity-connections/post_entityconnections.md): Initiates a connection request from a source entity to a target entity.

### User Access Permission
You must make the call as a source entity administrator. Also, this administrator must have permission to access to the target entity.

## Multi-entity: Accept a connection request

 - [PUT /v1/entity-connections/{connection-id}/accept](https://developer.zuora.com/v1-api-reference/older-api/entity-connections/put_entityconnectionsaccept.md): Accepts a connection request.

### User Access Permission
You must make the call as an entity administrator to accept a connection request.

## Multi-entity: Deny a connection request

 - [PUT /v1/entity-connections/{connection-id}/deny](https://developer.zuora.com/v1-api-reference/older-api/entity-connections/put_entityconnectionsdeny.md): Denies a connection request.

### User Access Permission
You must make the call as an entity administrator to deny a connection request.

## Multi-entity: Disconnect a connection

 - [PUT /v1/entity-connections/{connection-id}/disconnect](https://developer.zuora.com/v1-api-reference/older-api/entity-connections/put_entityconnectionsdisconnect.md): Disconnects an established connection. If you have shared objects from a global entity to a target entity, disconnecting the connection will break the mapping relationship between these entities and cannot be recovered later.

### User Access Permission
You must make the call as an administrator of the target entity or source entity.