Connectors

Connectors are integrations between Koladr and external services. They enable Koladr to execute approved actions on behalf of your agents — so your agents never need direct access to third-party credentials.

What Connectors Are

A connector is a configured link between Koladr and an external service like Gmail, Stripe, HubSpot, or Zendesk. When an agent action is approved, Koladr uses the appropriate connector to execute it.

This architecture provides two key benefits:

• Credential isolation. Your agents never see third-party API keys or OAuth tokens. Koladr holds the credentials and executes on their behalf.
• Centralized governance. Every action through a connector passes through your policies first. You get a single point of control for all external interactions.

How Connectors Work

The flow is:

1. An agent requests an action (e.g. email.send)
2. Koladr evaluates policies and determines the action is allowed
3. Koladr maps the action to the appropriate connector (e.g. Gmail)
4. The connector executes the action using its stored credentials
5. The result is logged in the run timeline

Connectors handle authentication, rate limiting, and error handling for the external service. Your agent code only needs to describe what it wants to do — not how to do it.

Supported Providers

Gmail

Send emails, read inbox, and manage drafts. Connects via OAuth 2.0. Supports actions like email.send, email.draft, and email.reply.

Stripe

Process refunds, check payment status, and manage subscriptions. Connects via API key. Supports actions like refund.create, payment.retrieve, and subscription.cancel.

HubSpot

Create and update contacts, deals, and tickets. Connects via OAuth 2.0. Supports actions like contact.create, deal.update, and ticket.create.

Zendesk

Manage support tickets, add comments, and update ticket status. Connects via API key or OAuth. Supports actions like ticket.update, ticket.comment, and ticket.resolve.

Connecting a Provider

To set up a connector:

1. Navigate to Connectors in the sidebar
2. Find the provider you want to connect
3. Click Connect
4. For OAuth providers (Gmail, HubSpot): complete the authorization flow in the popup
5. For API key providers (Stripe, Zendesk): enter your API key
6. Test the connection to verify it works

Once connected, the connector is available for all agents in your workspace. You can disconnect and reconnect at any time.

Governed Execution

The key insight of connectors is that they enforce the governance layer. Your agents cannot bypass Koladr to interact with external services directly — every action goes through the policy engine first.

This means:

• You have a complete audit trail of every external interaction
• Policies apply consistently regardless of which agent made the request
• You can revoke connector access without changing any agent code
• Credential rotation happens in one place, not across every agent

Current Status

In demo mode, connectors simulate the execution of actions and return realistic responses. This lets you build and test your full agent workflow — including policies and approvals — before connecting to live external services.