Skip to the documentation
API

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

Runs any of 3 calls on your workspace.

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