Docs / Connectors & Credentials/ Connectors & Credentials

Connectors & Credentials

Connect CRHQ to external services — API keys, OAuth integrations, and secure credential management.

Connectors and credentials let your agents interact with external services — Slack, Google Workspace, databases, APIs, and more.

What Are Connectors?

A connector represents an integration with an external service. It defines:

  • Service type — What it connects to (Slack, Google, custom API)
  • Authentication method — API key, OAuth, credentials, or multi-key
  • Configuration — Service-specific settings
  • Environment — Production, staging, or development

What Are Credentials?

Credentials are the actual secrets (API keys, tokens, passwords) stored securely in CRHQ. They're encrypted with AES-256-GCM and are never exposed in logs or conversations.

How They Work Together

  1. A connector defines the integration (e.g., "Slack")
  2. Credentials store the secrets needed (e.g., the Slack bot token)
  3. Access control determines which agents can use the connector
  4. Agents use the connector through their assigned skills

Available Connector Types

TypeDescription
API KeySimple key-based authentication (most common)
OAuthOAuth 2.0 flow with token refresh
CredentialsUsername/password pairs
Multi-KeyMultiple keys for a single service

Setting Up a Connector

  1. Go to Settings → Connectors
  2. Click Add Connector or select an existing one
  3. Choose the service and authentication type
  4. Enter the required credentials
  5. Set the environment (production, staging, development)
  6. Configure agent access

Tip: Check the Help Center for step-by-step guides on connecting specific services like Google Workspace and Slack.