Skip to main content
GET
/
v1
/
integrations
/
connections
List the calling org's connections
curl --request GET \
  --url https://api-sandbox.featherhq.com/v1/integrations/connections \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "nickname_slug": "<string>",
    "nickname": "<string>",
    "vendor": "<string>",
    "vendor_connection_id": "<string>",
    "status": "<string>",
    "tools_status": "<string>",
    "tools_synced_at": "2023-11-07T05:31:56Z",
    "status_reason": "<string>",
    "connected_at": "2023-11-07T05:31:56Z",
    "last_refreshed_at": "2023-11-07T05:31:56Z",
    "last_used_at": "2023-11-07T05:31:56Z",
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "tools": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "connection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "nickname_slug": "<string>",
        "tool_path": "<string>",
        "slug": "<string>",
        "display_name": "<string>",
        "description": "<string>",
        "input_schema": {},
        "is_enabled": true,
        "last_seen_at": "2023-11-07T05:31:56Z",
        "created_at": "2023-11-07T05:31:56Z",
        "updated_at": "2023-11-07T05:31:56Z",
        "stale_field_paths": [
          "<string>"
        ],
        "default_count": 123,
        "pinned_count": 123,
        "stale_input_fields": [
          "<string>"
        ],
        "merged_input_preview": {},
        "response_schema": {},
        "response_field_map": {},
        "input_defaults": {}
      }
    ]
  }
]

Authorizations

​
x-api-key
string
header
required

Response

Successful Response

​
id
string<uuid>
required
​
organization_id
string<uuid>
required
​
integration_key
enum<string>
required

Stable identifier for each supported integration.

The string value must match the vendor's per-provider identifier (for Nango: provider_config_key). Persisted on integration_connections.integration_key and integration_connection_tools.integration_key.

Adding a new integration: append a member here, add an IntegrationSpec to INTEGRATIONS, register the provider in the vendor cloud via src/integrations/bootstrap.py (Step 3).

Available options:
slack,
custom_mcp,
notion,
google_drive,
calcom,
twilio,
email
​
nickname_slug
string
required
​
nickname
string
required
​
vendor
string
required
​
vendor_connection_id
string | null
required
​
status
string
required
​
tools_status
string
required
​
tools_synced_at
string<date-time> | null
required
​
status_reason
string | null
required
​
connected_at
string<date-time> | null
required
​
last_refreshed_at
string<date-time> | null
required
​
last_used_at
string<date-time> | null
required
​
metadata
Metadata · object
required
​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
tools
ConnectionToolResponse · object[]