Skip to main content
GET
Get Integration

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

app_class_id
string
required

The integration's catalog identifier, such as okta.com, which GET /v1/integrations returns as app_class_id. It is not a UUID.

Response

Successful Response

A connectable integration from the app catalog (not a connected instance).

Read via the integration catalog endpoints. Carries catalog metadata only — no connection status. To read the state of an integration you have connected, use the Apps API.

app_class_id
string
required

Canonical identifier of the integration (e.g. okta.com). Pass it as app_class_id when connecting it with the Apps API's create endpoint.

name
string
required

Display name of the integration.

description
string | null

Short description of the integration.

category
string | null

Category of the integration (e.g. IT & Security).

logo_url
string | null

URL of the integration's logo.