Integrations - Membrane Docs

An integration represents a relationship between your product and a given external app. The integration list is a read-only catalog computed on the fly from Connectors and External Apps — there is no stored integration to create, edit, or delete. Entries derived from the catalog carry synthetic keys like ~connector.github.

Integration Definition

An integration entry looks like this:

name: Github
key: github
logoUri: https://static.integration.app/connectors/github/logo.png
connectorId: 62471fad996d5c297ae43f5f
connectorVersion: 2.3.1
authOptions:
  - title: API Key
    description: Connect using one of the Github API key types
    type: client-credentials
  - title: OAuth
    description: Connect in one click by approving this app's access
    type: oauth2

In this definition:

logoUri - URL of the publicly available image with the integration logo.
connectorId - id of the Connector this integration uses.
connectorVersion - the published connector version connections to this entry resolve against.
authOptions (read-only) - list of available authentication options based on the connector. The format of auth options matches the auth config from the Connector definition with all the Formulas resolved (if there were any).

Connection-level configuration

Connector parameters — OAuth client credentials, scopes, API-specific settings — are collected per Connection during the connect flow. They are not stored on the integration.