Connect an app by signing in

Connect Notion, HubSpot, Stripe, Airtable or another directory app by signing in, choose which of its tools to keep, turn tools on or off, and find your way around the integration's tabs.

Updated

Most apps in the directory connect by signing in. You click a card, sign in to the app in a window that opens, and tick the tools your agents may use. There is nothing to copy and no key to paste.

Copperleaf Bike Works keeps its service price list in Notion. Its front-desk agent, Copperleaf Front Desk, should be able to look up what a service costs while it talks to a customer.

Apps that sign in

These cards carry the Sign in label. Open them from Add integration on /integrations, from Popular apps, or from See all apps (/integrations/apps).

AppWhat the card says
Notion”Look up and update pages and databases.”
HubSpot”Find contacts and deals, log notes.”
Airtable”Search and add records.”
Stripe”Customers, payments and invoices.”
Square”Orders, customers and bookings.”
Make”Your Make scenarios as tools.”
Linear”Create and track issues.”
Asana”Tasks and projects.”
Jira & Confluence”Issues and team pages.”
Slack”Post updates to your channels.”

Zapier signs in too, and so does Zendesk through it: see Connect through Zapier. The Google cards have their own guide: Connect Google Sheets, Calendar, Docs, Drive and Chat.

Sign in

Click the card. A panel opens, titled “Connect Notion”, with the card’s line under it and one question:

“How do you want to connect?”

Each way the app offers is a card. For Notion there is one, Sign in with Notion — “A window opens. Nothing to copy.” Some apps offer more:

CardAppsWhat you do
Sign in with the appAll of the aboveSign in to the app in the window that opens
Personal access tokenAirtablePaste a token you made in the app: “Create one at airtable.com/create/tokens with access to the bases your agents need.”
Server URL with tokenMakePaste the server address, with its token in it
Through ZapierHubSpot, Airtable”Guided steps with your Zapier account.” See Connect through Zapier

Press Sign in with Notion at the bottom of the panel. The app’s own sign-in page opens in a window. Sign in with the account whose pages your agents should reach, and allow access. The window then says “Connected. You can close this window.”, and the panel moves on to choosing tools.

The integration takes the app’s name, Notion. You can rename it later on its Settings tab.

When the app asks for your own app

HubSpot and Asana may not register an app for us. The panel warns you first:

“HubSpot may ask you to create your own app first. If it does, we show the address to paste into it.”

If it does, the panel asks you to create an app in HubSpot, and shows Address to add to your app’s allowed redirect addresses with a Copy button. Add that address to your app, then fill in App ID and, if your app has one, App secret (“Leave empty if your app has no secret.”). Press Sign in with HubSpot again.

When sign-in doesn’t finish

Nothing is connected until the window says so. What it can say instead:

It saysWhat to do
”The sign-in was cancelled. Nothing was connected.”Start again and finish signing in
”The app didn’t accept the sign-in. Nothing was connected. Try again from Integrations.”Try again; check the account has access to what you are connecting
”This sign-in link has expired or was already used. Nothing was connected. Start again from Integrations.”Start again from the card
”Finish signing in from the browser where you started, signed in as the same person. Nothing was connected.”Sign in from the same browser and Omni Octo account you started in
”This server’s sign-in doesn’t meet the security we require.”The app can’t connect by signing in; use another way on its card if it has one
”The server didn’t answer within 15 seconds. Try again.”Try again in a minute

If you closed the window halfway, the app may already be in your list with nobody signed in. Its card now says Added, and opens the integration’s Authentication tab: “No one has signed in to Notion yet.” Press Sign in there.

Choose the tools to keep

Once you are signed in, the panel lists everything the app offers. It is titled Choose tools:

Choose tools for Notion: five Notion tools with notion-search and notion-fetch ticked and marked Only looks things up, and a Save 2 tools button.
Tick the tools your agents may use. A tool that only reads says Only looks things up.

“Tick the tools from Notion that your agents may use.”

Each tool shows the app’s own name for it and what it does. Search tools narrows the list, and the box’s header ticks or clears all of them at once. One line explains how they start:

“Tools from these services start on Messages and calls. A tool that may change things asks the customer first; one that only looks things up runs without asking. You can change both for each tool.”

Under each ticked tool is a switch, Ask the customer first. A tool that just reads says Only looks things up. Turn the switch off on a tool that may change things and it warns you:

“This tool may change things in Notion. The agent will run it without asking the customer.”

Leave it on unless you are sure. How the customer says yes is in Changes the customer confirms.

Some tools can’t be ticked, and say why, for example “This tool’s inputs can’t be described to the AI model, so an agent can’t use it.” You can add up to 100 tools at a time.

The button counts what you ticked: Save 2 tools. Copperleaf keeps two Notion tools that search and read pages, and nothing that edits them.

If the app has no tools yet, the panel says “The server has no tools yet. Add tools to it where you manage the server, then check again.”, with Check again. You can also close the panel without choosing. The app stays connected, and you choose tools later on its Tools tab.

Give the tools to an agent

The last step says “Notion is ready” — “2 tools added. Give them to an agent next.” — and “Connected as Notion.”

Under Give these tools to an agent is a button for each of your agents. Copperleaf Front Desk opens that agent’s Integrations tab with the Add dialog already open on Notion. Tools do nothing until an agent has them: see Give an agent tools from your other systems.

Done closes the panel and opens the new integration.

The integration’s page

Every integration has the same five tabs.

The Notion integration on its Tools tab: the five tabs, Who can use all tools and Choose tools, and two tools, Search and Fetch, each marked MCP and Reads data, used by Copperleaf Front Desk.
Every integration has the same five tabs. Tools lists what you kept and who uses it.
TabWhat it shows
OverviewKey: whether the sign-in works, and the default account. Used by: how many agents and workflows use it. Whether Octo uses it
ToolsEvery tool you kept, what it does, where it is used and which agents have it
AuthenticationThe accounts signed in, Check connection now, and Sign in with another account
SettingsName, Server address, Sign-in settings, and Octo can use this integration
ActivityCalls: each time an agent, a workflow, Octo or a check used a tool, over the Last 7 days. Changes: “The last 50 changes, newest first.”

The menu beside the integration’s name has Refresh tools (“List the server’s tools now. A changed tool pauses until you review it.”), Check connection now, Turn off and Delete….

Turn tools on or off

On the Tools tab, each tool is a card with its name, the app’s own name for it, a Reads data or Makes changes label, where it is used (Messages and calls), and which agents have it, or “not on any agent”.

ToDo this
Add more of the app’s tools, or drop someChoose tools. Untick a tool you have and it says Comes off when you save
Stop agents using a tool for nowThe tool’s menu, Turn off — “Agents stop using it. You can turn it back on.”
Remove a tool for goodThe tool’s menu, Delete…
Keep a tool from agents, Octo or workflowsThe tool’s AI agents, Octo or Workflows switch, or Who can use all tools

Dropping a tool that agents use asks first: “Remove a tool agents use?”, and names the agents.

Open a tool to change how it behaves: When should the agent use this?, and under Safety and availability, Ask the customer first and Use on (Messages, Calls). Under What the agent needs to ask for, Fill in automatically lets you give an input a fixed value, or an agent value, so the agent stops asking for it.

If the app changes a tool on its side, the tool says “Paused: changed on the server” with Review change. See When an integration needs you.

A second account

To add another account to the same app, open its card again. It now says Added, and opens the Authentication tab, where Sign in with another account adds it. Each agent can then use a different account: see Give an agent tools from your other systems.

Slack

Slack signs in the same way, with Sign in with Slack, but it is for workflows: “Workflows use this sign-in to reach Slack. Agents don’t.” Its card says “Used by: Workflows”. See Use integrations in workflows, or set them up with Octo.