Agent Integrations

VeriSwarm agents can connect to external services — calendars, CRMs, email, messaging, and more. Every integration call flows through Guard for PII tokenization and is recorded in Vault for audit.

How It Works

1. Connect — In your account settings, connect an integration via OAuth or API key.
2. Agent detects intent — When a user asks "schedule a meeting" or "look up the customer," the agent recognizes the integration action.
3. Runtime executes — The agent runtime calls POST /v1/integrations/execute with the provider, action, and parameters.
4. Guard intercepts — PII in requests and responses is automatically tokenized. Policy rules apply.
5. Result injected — The integration result flows back into the conversation, and the agent responds naturally.

Available Integrations

Scheduling

Integration	Actions	Auth
Google Calendar	list events, get event, create event, update event, delete event, find free slots, list calendars	OAuth 2.0
Calendly	list event types, list scheduled events, get event, list invitees, cancel event	OAuth 2.0

Email

Integration	Actions	Auth
Gmail	list messages, read message, send email, reply to message, search emails	OAuth 2.0
Microsoft 365	list emails, read email, send email, list calendar events, create calendar event, search files, read file content	OAuth 2.0

CRM

Integration	Actions	Auth
HubSpot	search/get/create/update contacts, list/create deals, log activities, search/create tickets	OAuth 2.0
Follow Up Boss	search/get/create contacts, add notes, list/create tasks	API Key

Documents

Integration	Actions	Auth
Google Workspace	search files, get file metadata, read document, list recent files, download file text	OAuth 2.0
DocuSign	list/get envelopes, list recipients, send envelope, list templates, void envelope	OAuth 2.0

Messaging

Integration	Actions	Auth
Slack	send message, list channels, read channel history, search messages, reply in thread	OAuth 2.0
Twilio	send SMS, send WhatsApp, list messages, get message	API Key
Telegram	send message, get updates, get bot info, get chat info	API Key

Support & Ticketing

Integration	Actions	Auth
Zendesk	search/get/create/update tickets, list comments, search users	API Token
Freshdesk	list/get/create/update tickets, search contacts, list conversations	API Key
Intercom	search/get contacts, list/get conversations, reply, search articles, create notes	OAuth 2.0
Jira	search issues (JQL), get/create issues, add comments, transition issues, list projects	API Token

Payments & Accounting

Integration	Actions	Auth
Stripe	list/get charges, list/get invoices, list subscriptions, search/get customers, get balance, create invoice, issue refund	API Key
QuickBooks Online	query, list/get invoices, list customers, P&L report, balance sheet, list accounts	OAuth 2.0
Xero	list/get invoices, list/get contacts, list accounts, P&L, balance sheet, list bank transactions	OAuth 2.0
Gusto	list employees, get employee, list payrolls, get PTO balances, list companies	OAuth 2.0
Expensify	list/get expense reports, create expense	API Key

Legal

Integration	Actions	Auth
Clio Manage	list/get matters, search/get contacts, list/create time entries, list documents, list calendar entries	OAuth 2.0
MyCase	list/get cases, search contacts, list/create time entries, list documents, list calendar	API Key

Real Estate

Integration	Actions	Auth
kvCORE	search/get/create leads, add notes, list listings	API Key
Zillow / MLS	search properties, get property details, get comparables, get Zestimate	API Key

Healthcare

Integration	Actions	Auth
Practice Management (FHIR)	search/get patients, list appointments, search practitioners, get schedule	API Key
Insurance Verification	check eligibility, list payers (Availity / Change Healthcare)	API Key

Connecting Integrations

OAuth Integrations (Google, HubSpot, Slack, etc.)

1. Go to Account > Integrations
2. Click Connect next to the integration
3. Authorize VeriSwarm in the provider's consent screen
4. You'll be redirected back with the integration connected

API Key Integrations (Stripe, Twilio, Zendesk, Jira)

1. Go to Account > Integrations
2. Click Connect next to the integration
3. Enter your credentials (API key, subdomain, etc.)
4. Click Save

Using Integrations from the API

Execute an Action

curl -X POST https://api.veriswarm.ai/v1/integrations/execute \
  -H "x-api-key: vs_..." \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "google-calendar",
    "action": "list_events",
    "params": {
      "max_results": 5,
      "time_min": "2026-03-27T00:00:00Z"
    }
  }'

List Connected Integrations

curl https://api.veriswarm.ai/v1/integrations/connected \
  -H "x-api-key: vs_..."

List Available Integrations

curl https://api.veriswarm.ai/v1/integrations/available

Guard Protection

All integration calls flow through Guard automatically:

• Outbound requests: PII in event descriptions, attendee emails, contact names, and message bodies is tokenized before leaving VeriSwarm.
• Inbound responses: PII in calendar events, CRM contacts, emails, and tickets is tokenized before entering the agent's LLM context.
• Audit trail: Every integration call is recorded in Vault with the provider, action, and timestamp.

For HIPAA-compliant integrations (healthcare agents), PHI tokenization applies to all integration data. For PCI-DSS (accounting agents), financial data tokenization applies.

Credential Security

• OAuth tokens are stored encrypted at rest
• Access tokens are automatically refreshed when they expire
• API keys are stored encrypted in the database
• Credentials are tenant-scoped (each workspace has its own connections)
• Disconnecting an integration deactivates the stored credentials

Adding Custom Integrations

VeriSwarm's integration adapter pattern makes it easy to add new providers. Each adapter is a single Python class that implements:

• get_oauth_url() / exchange_code() / refresh_access_token() — OAuth lifecycle
• list_actions() — describe available actions
• execute(action, params, access_token) — call the external API

See the Architecture docs for implementation details.