Connectors
Use a connection in your app
Link a connection to your app for the preview and the published app, and call the service from your app's server code.
On this page
Link a connection to an app when the app itself should work with the service, for example an app that lists the pages of your Notion roadmap, or a routine that posts a summary to Slack every morning. The app uses the account you link, and the published app keeps working when the person who linked it leaves the workspace.
Availability. The connector must be on for your workspace, and you need edit access to the app. Linking a connection for the published app also needs permission to publish the app. See Connect the tools you already use.
Preview and published app use their own connection
Every app has two connections per connector:
- Development is used by the preview, and by Ahamo's AI while it builds. Everyone who can edit the app can use the development connection in the preview.
- Production is used by the published app. Only people who can publish the app can change it.
They can be the same account or different ones, for example a Stripe Sandbox key while you build and a Live key for real payments.
Link a connection
You can ask in the chat, or link it yourself.
In the chat, ask for the outcome, such as "Show the pages of our Notion roadmap on the dashboard". When the app needs a connector, Ahamo shows a Connect … to this App card. Pick a connection and choose Use this connection, or Connect a new account. Someone who can publish can also tick Also use it in the published App. Choose Not now to continue without it.
In the app, open its Connectors. Choose Connect, pick the connector, and choose a connection for Development, Production, or both.
Each linked connector has a Name in code, by default the connector's name, such as notion. Your app's code reaches the account by that name. Change it only when the app needs two accounts of the same service, such as slack and slack-support.
The summary at the top of Connectors says whether every connection works and points out gaps, such as a preview without a connection or a production connection that needs you to sign in again.
Call the service from your app's code
Ahamo writes this code for you when you ask for a feature. If you read or edit the code, the calls look like this. They run only in the app's server code, never in the browser.
In a web app (server code):
import { connectors } from "@ahamo/runtime";
const res = await connectors.fetch("notion", "/v1/search", {
method: "POST",
body: JSON.stringify({ query: "Roadmap" }),
});In a Python API or routine:
from app.ahamo_connectors import connectors
res = connectors.request("notion", "POST", "/v1/search", json={"query": "Roadmap"})The code names the connector and a path at the service. Ahamo adds the sign-in or key on the way, so no token or key is ever part of your code. For Stripe, send a JSON body as usual; Ahamo sends it in the form Stripe expects.
Publish with your connections
A production connection takes effect when you next publish or deploy. If the app uses a connector in the preview but has no production connection for it, publishing stops and names the connector to connect. Open Connectors, choose a production connection, and publish again.
For Stripe, Ahamo warns you when the preview uses a Live key ("Payments in the preview will be real") or the published app uses a Sandbox key ("The published App will take no real payments"). Neither warning blocks you.
If a connector is turned off for your workspace or organisation, its calls are refused and publishing waits. Remove it from the app, or ask an admin to turn it on.
Remove a connection from an app
In Connectors, choose Remove on the connector. Code that uses it stops reaching the service within a few seconds, until you connect it again. The account itself stays connected. The published app keeps its production connection until someone who can publish removes it.
If you download your app's code, its README names each connector the app uses and how to replace it with your own key at the service.
Next, see Let Ahamo's AI use your tools in the chat or run work on a schedule with routines.