Skip to main content
GET
/
v1
/
integrations
List integrations
curl --request GET \
  --url https://api.example.com/v1/integrations \
  --header 'Authorization: <authorization>'

​
Overview

Returns all integrations currently connected for your tenant, including their connection status and metadata. Required role: admin or member

​
Request headers

​
Authorization
string
required
JWT Bearer token. Format: Bearer <your-jwt>.

​
Query parameters

​
status
string
Filter by status. One of: connected, disconnected, error.
​
provider
string
Filter by provider name (e.g. github, datadog, pagerduty).

​
Response

Returns 200 OK. 
{
  "items": [
    {
      "integrationId": "int_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "provider": "github",
      "status": "connected",
      "connectedBy": "user_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "connectedAt": "2024-03-01T09:00:00Z",
      "scopes": ["repo", "read:org"]
    },
    {
      "integrationId": "int_01HX9VTPQR3KF8MZWBYD5N6JCF",
      "provider": "datadog",
      "status": "connected",
      "connectedBy": "user_01HX9VTPQR3KF8MZWBYD5N6JCE",
      "connectedAt": "2024-03-05T14:00:00Z",
      "scopes": ["metrics_read", "logs_read"]
    }
  ],
  "total": 2
}
FieldTypeDescription
integrationIdstringUnique integration identifier
providerstringIntegration provider name
statusstringConnection status: connected, disconnected, error
connectedBystringUser ID who connected the integration
connectedAtstringISO 8601 timestamp
scopesstring[]OAuth or API scopes granted

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks required role

​
Examples

curl "https://api.causeflow.ai/v1/integrations?status=connected" \
  -H "Authorization: Bearer eyJhbGc..."

Integration catalog

Browse all available integrations

Connect integration

Connect a new integration to your tenant