Connectors Overview
What connectors are, how authentication works, and the full list of available integrations.
Connectors Overview
Connectors link external platforms to Reeve. Once connected, data flows into your Dashboard, agents can interact with the platform via specialized tools, and analytics populate automatically.
What Are Connectors?
A connector is a secure link between Reeve and an external service. Connectors:
- Pull data — Revenue, traffic, ad performance, email metrics, support tickets
- Enable agent tools — Agents use tools like
reeve_shopify,reeve_ads,reeve_emailto interact with connected platforms - Feed the dashboard — Each connected source adds a panel to the unified dashboard
You manage connectors from the Cockpit at Connectors in the sidebar.
Authentication Methods
Reeve uses two methods depending on the platform:
| Method | How it works | Security |
|---|---|---|
| OAuth | Click Connect → redirected to the platform → authorize → redirected back | Tokens managed automatically, refreshed before expiry |
| API Key | Click Connect → paste your key in a modal → validated and saved | Key encrypted with TokenVault before storage |
OAuth state tokens have a 10-minute TTL for CSRF protection. API keys are validated against the real API before saving — if the key is invalid, you'll see an error immediately.
Available Connectors
Commerce & Payments
| Platform | Auth | What you get |
|---|---|---|
| Shopify | OAuth | Products, orders, customers, revenue analytics |
| Stripe | OAuth | MRR, LTV, churn, subscriptions, payment history |
Advertising
| Platform | Auth | What you get |
|---|---|---|
| Meta Ads | OAuth | Campaign performance, ROAS, spend, audiences |
| Google Ads | OAuth | Search/display campaigns, keywords, conversions |
| TikTok Ads | OAuth | Short-form video campaign data |
Marketing
| Platform | Auth | What you get |
|---|---|---|
| Klaviyo | API Key | Email campaigns, flows, open/click rates, SMS |
Analytics
| Platform | Auth | What you get |
|---|---|---|
| PostHog | API Key | Page views, sessions, funnels, feature flags |
| Google Analytics | Service Account | Sessions, bounce rate, top pages, traffic sources |
Customer Support
| Platform | Auth | What you get |
|---|---|---|
| Gorgias | API Key | Support tickets, response times, CSAT |
| Zendesk | API Key | Tickets, agent performance, CSAT scores |
Development & Deployment
| Platform | Auth | What you get |
|---|---|---|
| GitHub | OAuth / App | Repos, PRs, CI/CD, deployment status |
| Vercel | API Key | Deployments, domains, build logs |
| Railway | API Key | Service status, deployment history |
| Figma | API Key | Design files, components, design tokens |
Communication
| Platform | Auth | What you get |
|---|---|---|
| Slack | OAuth | Bot access, channel messaging, workspace mapping |
How Agents Use Connectors
Once connected, your agents access platform data through specialized tools:
// Revenue from Stripe
reeve_revenue({ action: "get_summary" })
// Shopify store data
reeve_shopify({ action: "get_products" })
// Ad performance from Meta
reeve_ads({ action: "get_performance", platform: "meta" })
// Email campaigns from Klaviyo
reeve_email({ action: "list_campaigns" })
// Web analytics from PostHog/GA4
reeve_analytics({ action: "get_top_pages", period: "30d" })Agents never see raw API keys — the gateway resolves credentials through the Services API using encrypted service-to-service auth.
Connector data is fetched live when requested — Reeve doesn't store copies of your platform data. This means data is always current, but requires the external platform to be accessible.
Multi-Brand Support
In multi-brand mode, connectors are scoped per product/brand. Each brand can have its own Shopify store, ad accounts, and analytics — all managed from a single Reeve account.