> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmodus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connections

> List and find integration connections (client.connections).

### ConnectionsResource

```python
class ConnectionsResource(http: HttpClient, config: ModusConfig)
```

Bases: `object`

Read access to integration connections.

client.connections.list() → Page\[Connection] client.connections.find(name=”…”) → Connection | None

#### list()

```python
list(*, page_size: int = 25, page_token: str | None = None, type: str | None = None) → Page[ConnectionDto]
```

List integration connections the caller can use.

* Parameters:

  * **page\_size** – Items per page (default 25).

  * **page\_token** – Opaque token from a previous page’s `next_page_token`.

  * **type** – Filter by effective integration category (exact match).

#### find()

```python
find(*, name: str, type: str | None = None, page_size: int = 25) → ConnectionDto | None
```

Find the first connection whose name matches `name` (case-insensitive).

Pages through `list()` until a match is found or pages are exhausted.

### AsyncConnectionsResource

```python
class AsyncConnectionsResource(http: AsyncHttpClient, config: ModusConfig)
```

Bases: `object`

Async read access to integration connections.

#### list()

```python
async list(*, page_size: int = 25, page_token: str | None = None, type: str | None = None) → AsyncPage[ConnectionDto]
```

List integration connections the caller can use.

* Parameters:

  * **page\_size** – Items per page (default 25).

  * **page\_token** – Opaque token from a previous page’s `next_page_token`.

  * **type** – Filter by effective integration category (exact match).

* Returns:

  AsyncPage\[Connection] — iterate pages via `next_page_token`; each page is fetched through `_list_page`.

#### find()

```python
async find(*, name: str, type: str | None = None, page_size: int = 25) → ConnectionDto | None
```

Find the first connection whose name matches `name` (case-insensitive).

Pages through `list()` until a match is found or pages are exhausted.

* Parameters:

  * **name** – Connection name to match (trimmed and compared case-insensitively).

  * **type** – Optional category filter passed through to `list()`.

  * **page\_size** – Page size for each `list()` call while searching.

* Returns:

  The matching `Connection`, or `None` if no page contains a match.