Planned

Connecting an integration

Prepare, authorize, and validate connections safely.

When integration flows are available in your account, connecting follows the same pattern: choose the tool, grant scoped permissions, validate with a test action, then enable for specific agents.

Recommended steps

  1. 01
    Inventory scope

    List repos, channels, or datasets this agent needs — and what is explicitly forbidden.

  2. 02
    Connect with least privilege

    Start read-only; add write scopes only when workflows require them.

  3. 03
    Validate

    Run a test query or dry-run action and confirm audit logs show the attempt.

Next steps

If a connector fails, read Troubleshooting integrations.