Skip to main content
POST
/
v1
/
integrations
/
connections
/
{connection_id}
/
finalize
Finalize a connection after the OAuth popup closes
curl --request POST \
  --url https://api-sandbox.featherhq.com/v1/integrations/connections/{connection_id}/finalize \
  --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

Path Parameters

​
connection_id
string<uuid>
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[]