---
title: "List apps that can be connected"
description: "The apps that can be connected, most used first, one app by its slug, and the categories they are sorted into."
url: "https://openemail.uk/docs/api/connectors/apps"
area: "API"
category: "Mailbox"
---

# List apps that can be connected

The apps that can be connected, most used first, one app by its slug, and the categories they are sorted into.

`GET /connector-apps`

**Also documents:** `GET /connector-apps/{slug}`, `GET /connector-categories`

## GET /connector-apps

The apps that can be connected, most used first, one app by its slug, and the categories they are sorted into.

## Example

Needs `connectors:read`. `search` looks in the name and the description, and `category` takes a slug from `GET /connector-categories`. `limit` goes up to 60 and defaults to 24, and `cursor` takes the previous page’s `nextCursor`.

**curl**

```
curl "$OE/connector-apps?search=slack" -H "$AUTH"
curl "$OE/connector-apps/slack" -H "$AUTH"
curl "$OE/connector-categories" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
      "object": "connector_app",
      "slug": "slack",
      "name": "Slack",
      "description": "Channels and direct messages for teams.",
      "logo": "https://logos.example.com/slack.png",
      "website": "https://slack.com",
      "categories": [{ "slug": "communication", "name": "Communication" }],
      "actions": 130,
      "auth": "sign-in",
      "connectable": true
    }],
  "hasMore": false,
  "nextCursor": null
}
```

> `auth` is `sign-in` when a person signs in to the app, and `key` when they paste a key from it. It is null, and `connectable` false, for an app that cannot be connected yet.

> `actions` counts what the app offers. The actions themselves are listed through a connector, once the app is connected.

> The categories come back as one list of `slug` and `name`, without pages.

> A slug that names no app answers 404 `connector_app_not_found`.

## Reference

- [`GET /connector-apps`](https://openemail.uk/docs/api/reference/connectors#get-connector-apps): full reference
- [`GET /connector-apps/{slug}`](https://openemail.uk/docs/api/reference/connectors#get-connector-apps-slug): full reference
- [`GET /connector-categories`](https://openemail.uk/docs/api/reference/connectors#get-connector-categories): full reference