Skip to main content

Connections Guide

Adding a connection​

  1. Go to Connections → Add connection.
  2. Pick a connector. Use search or filter by domain.
  3. Choose an authentication method. Available types across all connectors:
    • api_key
    • basic
    • bearer
    • oauth2
    • pat
  4. Provide credentials. For OAuth flows, you'll be redirected to the vendor and back.
  5. Click Test to verify, then Save.

Credentials are encrypted at rest and never returned to the browser after save.

Multiple connections per domain​

You can connect the same domain to several instances - useful for prod vs staging, regional tenants, or M&A scenarios. One of them is the default for the domain; you can change which one from the connection list.

Routing a tool call to a specific connection​

Pass connection_id in the request body:

{
  "connection_id": "conn_abc123",
  "input": { "limit": 10 }
}

If omitted, Integration Hub uses the default connection for the tool's domain.

Per-agent preferences​

If you've created agents (API keys representing a specific AI persona), you can pin each agent to specific connections from Settings → Agents. The agent's preferences override the domain default.

Scopes​

Some connectors expose a subset of objects (e.g. only certain Slack channels or only one Workday business unit). Configure scopes from the connection's detail page.

Health checks​

Each connection runs periodic health checks. View results in Operations → Connector Health. Failing connections are flagged in the UI and excluded from automatic routing.

Disconnecting​

Removing a connection revokes its tokens (when supported) and disables routing to it. Audit history is preserved.