---
url: /process-functions/script-integrationconnections.md
description: Lists the integration connections set up on this instance.
---

# script.integrationConnections

Lists the integration connections set up on this instance. Use it to find a connection's name for [script.getOAuth](/process-functions/script-getoauth), or to check a connection exists before using it.

```js
script.integrationConnections(slug)
```

## Parameters

| Parameter | Type | Description |
|---|---|---|
| `slug` | `string` | Optional. The integration's slug, such as `"xero"`, from [script.integrationCatalog](/process-functions/script-integrationcatalog). Leave it out to list every connection. |

## Returns

The connections, each with:

* `name`: the connection's name, as passed to [script.getOAuth](/process-functions/script-getoauth).
* `type`: the integration the connection belongs to.
* `setup`: the connection's setup state, as a number.
* `last_renewal`: when the connection's tokens were last renewed.

Returns an empty array when there are no connections or the list can't be fetched.

## Examples

::: code-group

```js [connections.js]
const connections = script.integrationConnections("xero");
```

```json [Result]
[
    {
        "name": "Xero Production",
        "type": "xero",
        "setup": 1,
        "last_renewal": "2026-10-20 09:15:00"
    }
]
```

:::

## Related

* [script.integrationCatalog](/process-functions/script-integrationcatalog): lists the integrations and their slugs.
* [script.getOAuth](/process-functions/script-getoauth): returns the tokens for a connection.