# List connectors

> **GET** `https://api.us.nylas.com/v3/connectors`

Source: https://developer.nylas.com/docs/reference/api/connectors-integrations/get_connector_all/

List the connectors in your Nylas application.

**Authentication:** NYLAS_API_KEY

## Parameters

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `limit` | integer | No | Limit the number of results in a connector list. |
| `offset` | integer | No | Offset the list of results in a connector list. |

## Responses

### 200 - Returns an array of Connector objects.

- `request_id` (string) - ID of the request.
- `data` (array)
  - `name` (string) **(required)** - The name of the connector.
  - `provider` (string) **(required)** - Provider type
  - `settings` (object) - Optional settings from provider
  - `scope` (array) - (Not used for Zoom connectors.) Optional default scopes for the connector. For Zoom, configure scopes directly on your Zoom OAuth app. See [Zoom granular scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-granular/).
  - `active_credential_id` (string) - The ID of the "default" credential record of this Connector. This credential will be used as a default for communication with the provider.
- `limit` (integer)
- `offset` (integer)

### 401 - Not Authenticated

- `request_id` (string) **(required)** - ID of the request
- `error` (object) **(required)** - Error object
  - `type` (string) - Type of error
  - `message` (string) - Informative error message
  - `provider_error` (object) - (OPTIONAL) informative error message from provider's side

### 404 - Not Found

- `request_id` (string) **(required)** - ID of the request
- `error` (object) **(required)** - Error object
  - `type` (string) - Type of error
  - `message` (string) - Informative error message
  - `provider_error` (object) - (OPTIONAL) informative error message from provider's side

## Code samples

### cURL

```bash
curl --request GET \
  --url 'https://api.us.nylas.com/v3/connectors' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer <NYLAS_API_KEY>' \
  --header 'Content-Type: application/json'
```

### Node.js SDK

```javascript
import Nylas from "nylas";

const nylas = new Nylas({
  apiKey: "<NYLAS_API_KEY>",
  apiUri: "<NYLAS_API_URI>",
});

const listConnectors = async () => {
  try {
    const connectors = await nylas.connectors.list({});

    console.log("Connectors:", connectors);
  } catch (error) {
    console.error("Error fetching connectors:", error);
  }
};

listConnectors();

```

### Python SDK

```python
from nylas import Client

nylas = Client(
    "<NYLAS_API_KEY>",
    "<NYLAS_API_URI>",
)

connectors = nylas.connectors.list

print("Connectors:", connectors)

```

### Ruby SDK

```ruby
require 'nylas'

nylas = Nylas::Client.new(
    api_key: "<NYLAS_API_KEY>",
)

connectors = nylas.connectors.list()

puts connectors

```

### Java SDK

```java
import com.nylas.NylasClient;
import com.nylas.models.*;

public class ListDraft {
    public static void main(String[] args) throws 
    NylasSdkTimeoutError, NylasApiError {
        NylasClient nylas = 
        new NylasClient.Builder("<NYLAS_API_KEY>").build();

        ListResponse<Connector> connectors =
        nylas.connectors().list();
        System.out.println(connectors);
    }
}

```

### Kotlin SDK

```kotlin
import com.nylas.NylasClient

fun main(args: Array<String>) {
    
    val nylas: NylasClient = NylasClient(
        apiKey = "<NYLAS_API_KEY>"
    )

    val connectors = nylas.connectors().list()
    println(connectors)
}

```