Wato Docs
Connectors

Install & Configure

Authenticate a connector for your team, set any per-connector config, and sync its tools.

Once a connector is approved for your team, install and configure it at Teams → [Team] → Connectors → [connector]. Configuring a connector's credentials needs tools:manage or team admin.

Authenticate

How you authenticate depends on the connector:

  • OAuth — most connectors. Click Connect and complete the OAuth flow. Composio-backed connectors use Composio-managed OAuth; native connectors run a standard OAuth flow. Credentials are stored encrypted server-side.
  • API key — some connectors authenticate with keys instead of OAuth (for example AWS, Datadog, Clay, Gong, BuiltWith). You paste the credential into the Connect with API keys dialog; Wato encrypts it and attaches it to tool calls as the right headers.

Credentials never reach the browser or the agent

Wato encrypts connector credentials server-side and only decrypts them when it calls the connector on your behalf. Agents call tools through the gateway and never receive the underlying tokens or keys.

Per-connector configuration

Some connectors need extra configuration beyond credentials — for example an AWS region or a Datadog site/region. The connector page shows a config form for these. Set the config before (or alongside) saving credentials. See the Datadog guide for a worked example.

Sync tools

After authenticating, sync the connector to fetch its current tool list. Syncing populates Wato's tool catalog for that connector (names, descriptions, input/output schemas) so agents can discover and call the tools, and so admins can set per-tool access. A successful sync flips the connector's verification status to verified; a failure shows failed with a message.

Status reference

Connector statusMeaning
requestedA member asked for the connector; awaiting admin approval.
approvedApproved by an admin (intermediate).
installedActive for the team or org.
rejectedThe request was declined.
disabledPreviously installed, now turned off.
Verification statusMeaning
pendingNot yet verified.
auth_requiredAuthentication is needed or in progress.
verifiedReachable; tools synced.
failedThe endpoint errored or tools couldn't sync.

Next

On this page