> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - If a reference page seems to be missing its schema (parameters, return types, or type definitions), append `?schema=true` to its `.md` URL (e.g. `https://dev.wix.com/docs/contexts/contexts/stores/category-info/use-category-info-context.md?schema=true`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

# ListConnections

# Package: conferencing

# Namespace: ConferencingService

# Method link: https://dev.wix.com/docs/api-reference/business-management/calendar/conferencing/conference-v1/list-connections.md

## Permission Scopes:
Manage_Wix_Rentals_App_Forms_submissions: SCOPE.RENTALS.MANAGE

## Introduction

Retrieves the conferencing provider connections matching the filter.

Returns the status of each connection, sorted by `connectedDate` in descending order.

Callers with the Manage All Conferencing permission see every connection in full. Other callers see their own resource's connections and the business resource's connections in full. For all other connections, sensitive fields are returned empty.

---

## REST API

### Schema

```
 Method: listConnections
 Description: Retrieves the conferencing provider connections matching the filter.  Returns the status of each connection, sorted by `connectedDate` in descending order.  Callers with the Manage All Conferencing permission see every connection in full. Other callers see their own resource's connections and the business resource's connections in full. For all other connections, sensitive fields are returned empty.
 URL: https://www.wixapis.com/calendar/v3/conferences/v1/connections
 Method: GET
 Method parameters:
   query param name: resourceIds | type: array<resourceIds> | description: Resource GUIDs to filter by.  Default: When empty, returns all connections.  | validation: maxItems 100, format GUID
 Return type: ListConnectionsResponse
  - name: connections | type: array<Connection> | description: Retrieved provider connections.  
     - ONE-OF: 
        - name: oauthDetails | type: OAuthConnectionDetails | description: Set when `connectionMethod` is `OAUTH`.  
           - name: email | type: string | description: Email address of the authorized provider account.  Returned empty for callers who aren't authorized to view connections owned by other resources.  | read-only: true | validation: maxLength 320
        - name: credentialsDetails | type: CredentialsConnectionDetails | description: Set when `connectionMethod` is `CREDENTIALS`.  
           - name: userName | type: string | description: Username, often an email address, of the credentialed account.  | read-only: true | validation: maxLength 500
        - name: customDetails | type: CustomConnectionDetails | description: Set when `connectionMethod` is `CUSTOM`.  
           - name: conferenceUrl | type: string | description: Static conference URL.  | read-only: true | validation: maxLength 2048
           - name: description | type: string | description: Human-readable description of the link. For example, `Personal Zoom Room`.  | validation: maxLength 500
           - name: password | type: string | description: Conference password. Returned empty for callers who aren't authorized to view it.  | validation: maxLength 500
     - name: id | type: string | description: Connection GUID. Generated by the provider.  | read-only: true | validation: format GUID
     - name: status | type: ConnectionStatus | description: Connection status.  
         - enum:
         -     CONNECTED: The connection is usable now.
         -     DISCONNECTED: The user or your implementation intentionally disconnected the account.
         -     ERROR: The connection was established but is now broken, for example tokens were revoked or expired externally, and needs reconnection.
     - name: connectionMethod | type: ConnectionMethod | description: Method used to establish this connection.  
         - enum:
         -     OAUTH: OAuth authorization flow.
         -     CREDENTIALS: Username and password authentication.
         -     CUSTOM: Static custom link: a URL with an optional password and description, stored by Wix.
     - name: appId | type: string | description: GUID of the conferencing provider app.  | validation: format GUID
     - name: appName | type: string | description: Display name of the provider app. For example, `Zoom` or `Google Meet`.  | validation: maxLength 200
     - name: connectedDate | type: string | description: Date and time the connection was established, in UTC.  | read-only: true | validation: format date-time
     - name: resourceId | type: string | description: GUID of the resource. Replaces `accountOwnerId`.  | read-only: true | validation: format GUID


```

### Examples

### List a resource's connections
Retrieves the conferencing connections of a resource.

```curl
curl -X GET \
'https://www.wixapis.com/calendar/v3/conferences/v1/connections?resourceIds=a1f3c9e2-6b7d-4e58-9c0a-2d4b8e7f1356' \
-H 'Authorization: <AUTH>'
```

---

## JavaScript SDK

### Schema

```
 Method: wixClientAdmin.calendar.conferencing.listConnections(options)
 Description: Retrieves the conferencing provider connections matching the filter.  Returns the status of each connection, sorted by `connectedDate` in descending order.  Callers with the Manage All Conferencing permission see every connection in full. Other callers see their own resource's connections and the business resource's connections in full. For all other connections, sensitive fields are returned empty.
 Method parameters:
   param name: options | type: ListConnectionsOptions  none  
        - name: resourceIds | type: array<string> | description: Resource GUIDs to filter by.  Default: When empty, returns all connections.  | validation: maxItems 100, format GUID
 Return type: PROMISE<ListConnectionsResponse>
  - name: connections | type: array<Connection> | description: Retrieved provider connections.  
     - ONE-OF: 
        - name: oauthDetails | type: OAuthConnectionDetails | description: Set when `connectionMethod` is `OAUTH`.  
           - name: email | type: string | description: Email address of the authorized provider account.  Returned empty for callers who aren't authorized to view connections owned by other resources.  | read-only: true | validation: maxLength 320
        - name: credentialsDetails | type: CredentialsConnectionDetails | description: Set when `connectionMethod` is `CREDENTIALS`.  
           - name: userName | type: string | description: Username, often an email address, of the credentialed account.  | read-only: true | validation: maxLength 500
        - name: customDetails | type: CustomConnectionDetails | description: Set when `connectionMethod` is `CUSTOM`.  
           - name: conferenceUrl | type: string | description: Static conference URL.  | read-only: true | validation: maxLength 2048
           - name: description | type: string | description: Human-readable description of the link. For example, `Personal Zoom Room`.  | validation: maxLength 500
           - name: password | type: string | description: Conference password. Returned empty for callers who aren't authorized to view it.  | validation: maxLength 500
     - name: _id | type: string | description: Connection GUID. Generated by the provider.  | read-only: true | validation: format GUID
     - name: status | type: ConnectionStatus | description: Connection status.  
         - enum:
         -     CONNECTED: The connection is usable now.
         -     DISCONNECTED: The user or your implementation intentionally disconnected the account.
         -     ERROR: The connection was established but is now broken, for example tokens were revoked or expired externally, and needs reconnection.
     - name: connectionMethod | type: ConnectionMethod | description: Method used to establish this connection.  
         - enum:
         -     OAUTH: OAuth authorization flow.
         -     CREDENTIALS: Username and password authentication.
         -     CUSTOM: Static custom link: a URL with an optional password and description, stored by Wix.
     - name: appId | type: string | description: GUID of the conferencing provider app.  | validation: format GUID
     - name: appName | type: string | description: Display name of the provider app. For example, `Zoom` or `Google Meet`.  | validation: maxLength 200
     - name: connectedDate | type: Date | description: Date and time the connection was established, in UTC.  | read-only: true 
     - name: resourceId | type: string | description: GUID of the resource. Replaces `accountOwnerId`.  | read-only: true | validation: format GUID


```

### Examples

### List a resource's connections
Retrieves the conferencing connections of a resource.

```javascript
import { conferencing } from "@wix/calendar";

async function listConnections() {
  const response = await conferencing.listConnections({
    resourceIds: ["a1f3c9e2-6b7d-4e58-9c0a-2d4b8e7f1356"],
  });
}

/* Promise resolves to:
 * {
 *   "connections": [
 *     {
 *       "_id": "a1f3c9e2-6b7d-4e58-9c0a-2d4b8e7f1356",
 *       "status": "CONNECTED",
 *       "connectionMethod": "OAUTH",
 *       "appId": "c6d111d1-1a8d-49f0-a78c-4f1823fb6592",
 *       "appName": "Zoom",
 *       "connectedDate": "2026-11-02T08:14:22.512Z",
 *       "resourceId": "a1f3c9e2-6b7d-4e58-9c0a-2d4b8e7f1356",
 *       "oauthDetails": {
 *         "email": "dana.levi@example.com"
 *       }
 *     }
 *   ]
 * }
 */

```

### listConnections (self-managed)
Self-managed SDK calls require you to [create a client](https://dev.wix.com/docs/sdk/articles/work-with-the-sdk/about-the-wix-client.md).

```javascript
import { createClient } from '@wix/sdk';
import { conferencing } from '@wix/calendar';
// Import the auth strategy for the relevant access type
// Import the relevant host module if needed

const myWixClient = createClient ({
  modules: { conferencing },
  // Include the auth strategy and host as relevant
});


async function listConnections(options) {
  const response = await myWixClient.conferencing.listConnections(options);
};
```

---