Connecting your tools | Viktor Academy
Viktor can already think, write, and research from anything you paste him.
The moment you connect your real tools, he stops being a smart assistant and starts acting on your behalf in the software your business actually runs on.
Connecting your stack is the single biggest upgrade you can give him.
By the end you should know how to
- Understand what integrations unlock
- Connect any tool with the one-click flow, whatever tier it lives in
- Know what a token is, and why a connection sometimes needs reconnecting
- Manage multiple accounts and team access
- Know when to ask Viktor support versus the tool's own support
- Troubleshoot common connection issues yourself
Why connect your tools
An unconnected Viktor can think, write, and research. A connected Viktor can act. That is the line between a smart assistant and an actual employee, and the only thing standing between the two is a one-click connection to the tools your business already runs on.
Without integrations
- You: "Draft me an email about the product launch."
- Viktor writes the text and pastes it back in your chat.
- You copy it, open Gmail, add recipients, and send it yourself.
With integrations
- You: "Send an email about the product launch to our beta users."
- Viktor drafts it and shows a preview.
- After you approve, he sends it from your Gmail.
Here is what connecting a few tools unlocks:
| Tool connected | What Viktor can do |
|---|---|
| Gmail | Draft, send, and read emails. Manage labels. Search your inbox. Build email workflows. |
| Google Drive | Create, edit, and share files. Upload reports. Organize folders. Search across your Drive. |
| Google Calendar | Create events, check availability, send invites, manage recurring meetings. |
| Post content, engage with comments, manage your professional presence. | |
| Hootsuite | Schedule posts across platforms, manage a content calendar, track publishing. |
| Stripe / PayPal | Look up transactions, generate payment reports, track revenue. |
| Salesforce / HubSpot | Manage contacts, update deals, create reports, automate CRM workflows. |
The whole idea Integrations are what turn a smart assistant into an actual employee. Thinking and writing are table stakes. Acting on your behalf, in the tools your business runs on, is the part that gives you back real hours.
How integrations work
One-time setup, about 30 seconds. The first time Viktor needs a tool, he walks you through it:
You ask "Send an email to the team."
Viktor sends a link "Connect Gmail to continue."
You authorize Click Allow in your browser.
Connected Viktor continues automatically.
Connect once, not every time Once you authorize a tool, Viktor remembers it. You do not reconnect every time, until the token expires.
What is a token, and why does a connection sometimes need reconnecting?
When you connect a tool, it hands Viktor a token: a digital keycard, not your password. That keycard is what lets him act on your behalf. Like any keycard, it can stop working, and when it does, reconnecting is all it takes to issue a fresh one. Nothing is broken. Here is the mental model:
How tokens work
| What it means for you | Description |
|---|---|
| Tokens are scoped | Each token only has access to what you approved. Connect Gmail and Viktor cannot touch Drive unless you also connect Drive. |
| Tokens can expire | Many tools refresh in the background and you never notice. Others expire after a set period, or get invalidated the moment you change a password. That is when Viktor asks you to reconnect, and it is routine, not a sign anything went wrong. |
| Tokens are revocable | Disconnect any tool any time from your Viktor settings. The token is invalidated immediately. |
| Tokens are secure | Viktor stores tokens encrypted. Your passwords are never seen or stored. The tool itself handles authentication. |
The three integration tiers
Viktor reaches 3,200+ tools through three tiers. They differ in depth, not in how you connect them.
Native Built in. The tools Viktor knows best, with the deepest functionality: Gmail, Drive, Notion, Stripe, Salesforce, and more.
Extended library Covers most of the popular tools teams use: Hootsuite, Constant Contact, Jotform, SurveyMonkey, and many more.
Specialized connectors For specific platforms: HubSpot, Instagram, YouTube, WhatsApp, Reddit Ads, and others.
You do not need to know the tier Just ask Viktor for the tool you want. He finds the right connection and walks you through it. Native tools generally offer the deepest functionality, but the way you connect is the same across all three.
Connecting your first integration
There are two ways to connect a tool. Most people never leave their chat.
How Just ask Viktor right in your chat what you want done. If a tool is not connected yet, he sends a Connect button right there (Slack or Teams).
Method 1: Viktor prompts you (recommended)
- Ask Viktor to do something that needs a tool.
- Viktor sends a Connect button right in your chat (Slack or Teams).
- Click it and authorize in your browser (Allow).
- Viktor picks up where it left off.
Method 2: connect from settings
- Go to app.viktor.com/integrations.
- Browse or search across all 3,200+ integrations.
- Click Connect and authorize.
Connect ahead of the work If you know you will want email, calendar, and file management, connect Gmail, Google Calendar, and Google Drive upfront so Viktor is ready the moment you ask. Connecting your tools early is also one of the fastest ways to pad your credit balance: new workspaces earn bonus reward credits for the first tools they connect.
The most popular integrations
The connections most teams reach for first, and what each one unlocks:
Gmail Send, draft, and read email. Search your inbox, manage labels, build workflows.
Google Drive Create, edit, and share Docs, Sheets, and Slides. Upload and organize files.
Google Calendar Create events, check availability, send invites, manage recurring meetings.
LinkedIn Post, engage with comments, manage personal and company pages.
Hootsuite Schedule across platforms, run a content calendar, track publishing.
Constant Contact Run campaigns, manage contact lists, track open rates.
Stripe Look up transactions, generate reports, track revenue.
Notion Search, create, and update pages, databases, and your knowledge base.
GitHub Clone repos, manage branches, open pull requests, track issues.
HubSpot Manage contacts and deals, build reports, automate CRM workflows.
Don't see your tool? Ask Viktor "Can you connect to [tool name]?" and he searches the full library or sets up a custom API connection.
Multiple accounts and shared access
You can connect the same tool more than once: personal Gmail, work Gmail, a team shared inbox. Viktor keeps them straight.
| Feature | How it works |
|---|---|
| Labels | Each connection gets a friendly label ("Personal Gmail," "Work Gmail"). Specify which account, or Viktor asks. |
| Shared connections | A connection can be shared with the whole team. Everyone uses it without connecting individually. Good for shared inboxes or company social accounts. |
| Restricted connections | A connection can be restricted to specific people. Useful for sensitive accounts like finance or HR. |
"Can't access a tool you know is connected?" It may be restricted to another team member. Check app.viktor.com/integrations.
Permissions and approval controls
You decide how much Viktor can do on his own. Every integration runs in one of three modes:
Auto-Run Viktor acts without asking. Best for low-risk, high-frequency tasks like "check my calendar."
Ask First Viktor shows what it wants to do and waits for approval. Best for sensitive actions like "send this email."
Disabled Viktor cannot use the integration even if connected. Good for pausing access.
Set this per integration, per user, even per tool. Gmail alone has "send email," "read email," and "search inbox." Manage it all at app.viktor.com/integrations, or just tell Viktor "Change Gmail send email to ask first."
A mental model for permissions Think of it as confidence, not caution. Start most tools on Ask First while you learn how Viktor works. Move the low-risk, high-frequency ones (checking a calendar, reading a doc) to Auto-Run as you build trust. Reach for Disabled when you simply want to pause a tool without disconnecting it. You can change any of this at any time.
Custom API connections
For internal, niche, self-hosted, or brand-new tools that are not in the library yet, Viktor can connect directly with an API key.
When you'd need it
| Example | Description |
|---|---|
| Internal company tool | A dashboard your team built in house. |
| Niche industry software | A vertical tool specific to your trade. |
| Self-hosted services | GitLab, Mattermost, or Nextcloud at your own domain. |
| Brand-new tools | Something too new to be in the standard library. |
How it works:
- Tell Viktor: Describe the tool and what you want done.
- Provide API key: Send it in a direct message, never a public channel.
- Viktor tests it: He confirms the connection works.
- Ready to use: Ask for the work as usual.
What you need
an API key or access token, the base URL if self-hosted, and a one-line description of what you want Viktor to do.
Keep keys safe
API keys are stored encrypted, like OAuth tokens. Never share keys in public channels. Send them to Viktor in a direct message, or add them at app.viktor.com/integrations. Most teams never need this. The 3,200+ library covers the vast majority of use cases.
Tips for better results
Do
- Connect tools before you need them.
- Use clear labels for multiple accounts.
- Start in Ask First mode.
- Tell Viktor which account to use.
- Reconnect promptly when asked.
Don't
- Connect more than you need.
- Ignore expiration notices.
- Share sensitive connections team-wide.
- Assume all tools are equal. Native tools run deeper than the extended library or specialized connectors.
- Change passwords without reconnecting afterward.
Who to contact for help
When something goes wrong, the fix is faster if you know who owns the problem.
Contact Viktor support
support@viktor.com, or message Viktor right in your chat
- The connection itself is broken: says "not connected" but you connected it, the Connect page errors, a connected tool is not seen.
- Viktor behaves unexpectedly: wrong account, ignoring permissions, worked yesterday but not today.
Contact the tool's support
the company that makes the tool
- The tool itself has a problem: it is down for everyone, account suspended, you hit its rate or plan limits.
- Account or billing issues: expired plan, verification, password change.
A simple test Can you log in to the tool directly? No, the tool is down, contact the tool. Yes, contact Viktor support. Not sure? Just ask Viktor. He diagnoses token versus service issues.
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| "Viktor says my Gmail isn't connected, but I connected it last week" | Token expired or revoked | Reconnect at app.viktor.com/integrations. 30 seconds. |
| "Viktor connected to the wrong account" | You were logged into a different account when you authorized | Disconnect and reconnect. Make sure you're in the correct account first. |
| "I connected a tool but Viktor doesn't see it" | Refresh delay (1 to 2 minutes) | Wait and try again. After 5 minutes, ask Viktor to check its connections. |
| "Viktor says it doesn't have permission" | Set to Disabled or restricted to another member | Check permissions at app.viktor.com/integrations. Set to Ask First or Auto-Run. |
| "I changed my password and now the integration is broken" | Password change invalidated the token | Reconnect the affected tools after any password change. |
| "Viktor sent an email from the wrong Gmail" | Multiple accounts without clear labels | Add labels and specify the account: "Send from my work email." |
| "I can't find my tool in the integration list" | Different name or needs a custom API | Ask "Can you connect to [tool]?" Viktor searches all options or suggests a custom API. |
| "The connect button doesn't work" | Popup or ad blocker | Try another browser or disable popup blockers for app.viktor.com. |
Ready to give Viktor his first tool?
The fastest way to start is to ask. Tell Viktor what you want to do, and if a tool needs connecting he walks you through it in seconds.
After the intro, I tell everyone the same thing: "Use Viktor the way you would message a new team member. Be specific about what you want, tell it when you want it done, and check the first few results." The teams that follow this are fully autonomous by end of week.