Skip to main content
POST
Connect an app at the organization level

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Path Parameters

provider
string
required

App provider identifier (for example gmail, github, jira).

Body

application/json

Direct-credential connect (API key and credentials-import apps). The required fields keys are the app's own and are listed on its integration page.

fields
object

The app's credential fields (for example { "apiKey": "…" }).

connectionId
string

Re-authenticate this existing connection instead of creating a new one.

label
string

Display label for the new connection. Defaults to an identity extracted from the credentials.

method
string

For apps that offer more than one direct method, which one fields belongs to.

Response

Connected

success
boolean