Connecting an integration: the connect flows Guide

Praxivara connects to the tools you already use so your assistant and your agents can work inside them. Because every provider signs you in a little differently, the connect step adapts to the app. This guide walks through each connect method so you know what to expect before you click Connect.

Where connecting starts

Every connection begins on your Integrations hub. Open the Integrations page, then search or filter by category to find the app you want. Each app has a card you can open to see what it does before you commit.

When you're ready, open the app's card and choose Connect. What happens next depends on which of the flows below the app uses. Connections are private to you and scoped to your workspace.

Tip: If you can't find an app, try a different category or an alternate name. Research and data-source integrations often appear as "<Company> Research."

Sign-in popup (Google, Microsoft, Slack)

Google apps (such as Gmail, Calendar, Drive, Docs, Sheets, Tasks, Contacts, and Meet), Microsoft apps (Outlook Mail and Calendar), and Slack connect through the provider's own secure sign-in screen.

1. Select Connect on the app's card.
2. A popup opens on the provider's site. Sign in with the account you want Praxivara to use.
3. Review the permissions the provider shows you and approve them.
4. The popup closes and you return to the hub, where the app now shows as connected.

Make sure you sign in with the correct account — the one whose email, calendar, or workspace you want the assistant to act in. If your browser blocks the popup, allow popups for Praxivara and try again.

Hosted connect window (many third-party apps)

Many apps — including HubSpot, Pipedrive, Salesforce, Zoho, Stripe, QuickBooks, Shopify, Dropbox, Zoom, DocuSign, Calendly, and others — connect through a hosted connect window that guides you through the provider's authorization.

1. Select Connect on the app's card.
2. Follow the prompts in the connect window to sign in and authorize the app.
3. Grant the access the provider requests.
4. Return to the hub and confirm the app shows as connected.

Finish the window promptly. If it sits open too long you may see a message that the connection link expired — just start the connect flow again.

API key or credentials (a few apps)

A small number of apps connect by pasting a key or credentials you generate in that provider's own dashboard. For example, Firecrawl uses an API key, IPinfo uses a token, and Twilio uses your Account SID and Auth Token.

1. Generate the key or credentials in the provider's dashboard.
2. Select Connect on the app's card in Praxivara.
3. Paste the key or credentials into the fields shown.
4. Submit to validate and save the connection.

If you see a message that the key couldn't be validated, double-check that you copied the full value with no extra spaces and that it's still active in the provider's dashboard.

Apple Calendar

Apple Calendar connects with your iCloud email and an app-specific password — not your normal iCloud password. Create the app-specific password in your Apple account settings, then enter your iCloud email and that password when connecting. Using a regular iCloud password is the most common reason this connection fails.

One-click Add (Research data sources)

Research data sources connect with a single click and no sign-in. Open the source's card and choose Add. It becomes available to your assistant and agents right away.

After you connect

Connecting links the account. Before your assistant can act, you also choose which of the app's actions it's allowed to perform — a per-connection list you can review while connecting and adjust later. If the assistant ever reports that a specific action isn't enabled, you can turn that action on from the connection's management view.

From there you can also manage the connection over time: connect additional accounts, set a primary account, reconnect if access lapses, or disconnect entirely.