Account connections

A connection is a service key (Resend, Stripe, OpenAI…) saved in your account, not in a single project. You paste it once, then link it to as many projects as you like. When you replace it, every linked project gets the new key.

The Connectors page (in the sidebar) gathers three kinds of services:

Kind	Examples	Used by	What you save
“Your own key” connectors	Resend, Stripe, OpenAI, Slack…	Your apps	One or more connections (keys), linked to your projects
Google Sheets	Google Sheets	Your apps	Your Google account, shared by all your projects
Context sources	Notion, Linear, Figma, Kameleoon	The agent	Your account with the service, read by the agent while it answers

The Used by filter (All, Your apps, The agent) shows only one family or the other.

Save a connection

1. Open the Connectors page from the sidebar. From a project, you can also use the input box’s + menu → Manage connectors (the page opens in a new tab, your project stays open).
2. Find the service (Search connectors field, or /) and click its card to open its details.
3. In the Setup part, the New connection form is shown (or click Add a connection if there’s already one).
4. Give it a name if you want, for example “Stripe prod” (Name (optional) field). Without a name, Highwind names it after the service: “Stripe”, then “Stripe 2”, “Stripe 3”…
5. Paste the requested value(s). The Where to find the key link takes you to the right page at the service. When a value always starts the same way, the label says so (“starts with …”) to help you spot a wrong paste.
6. Click Add. The key is encrypted, saved, then tested with the service (see below).

A connection created from a project’s card (The agent needs your … connection) is saved in your account the same way: if you paste a key you’ve already saved, Highwind reuses the existing connection instead of creating a second one.

One key per connection, several connections per service

Each connection keeps one key, encrypted. You can have several for the same service, for example a test key and a production key, and link one or the other depending on the project. An account can keep up to 50 connections.

Link a connection to a project

A project uses at most one connection per service. Three ways to link one:

• From the chat: when the agent wires in a service, the card The agent needs your … connection offers Use a connection from your account. One click is enough.
• From the project settings: Project settings → Connectors, open the service’s details. Your connections are listed there (with Used by 1 project, Not linked to any project…): click Use. The linked connection is marked Linked, with the sentence “This project uses the “…” connection from your account”.
• With a new key: in the same details, New key creates a connection in your account and links it to the project.

Once linked, the key also shows up in Project settings → Secrets, marked Via the “…” connection. The app’s server reads it like any secret (env.NAME), in the preview and once published.

To stop a project from using a connection, click Unlink (in the connector’s details or in the project’s secrets). The connection stays in your account; only that project loses the key.

Test, replace, rename, delete

On the Connectors page, a service’s details list its connections. For each one, you see its name, any public values and the projects using it (Used by … or Not linked to any project). Four actions:

Action	What happens
Test the key	Highwind calls the service with the key, without side effects, and shows the result.
New key	You paste the new value. It replaces the old one in every linked project (“The new key will replace the old one in the … linked projects”), in the preview and in live apps. For a service with several fields, a field left empty stays unchanged.
Rename	Only changes the displayed name (60 characters at most).
Delete	The key is permanently erased. If projects use it: “The … linked projects will lose this key: the features using it will stop working.”

Before deleting a connection

Deleting a connection removes the key from every linked project, including their live apps: the forms, payments or messages that depend on it stop right away. Link another connection to those projects first if you want them to keep working.

Key checks

Whenever a key is added or replaced, and when you click Test the key, Highwind makes a small call to the service to check that it works. This check has no side effects: it reads something harmless (for example your list of domains at Resend), without sending an email, creating a payment or posting a message. Each connector’s page says what its check does.

Three possible results:

• The key works;
• Key refused by the service: make sure you copied the right value, in full, and that it has the required permissions; then use New key;
• Service unreachable, try again later: the service didn’t answer. The key is still saved; this isn’t a refusal.

Tip

If a feature of your app that used to work stops (no more emails, payments refused), start with Test the key: a key revoked or expired at the service is the most common cause.

Google Sheets: one account for all your projects

Google Sheets doesn’t use a key but your Google account, connected once for all of Highwind. Each project then gets its own spreadsheet. On the Connectors page, the Google Sheets details show Connected as followed by the account’s address, and a Disconnect button.

The Google account is connected from a project, when an app saves to Google Sheets (Connect your Google account card in the chat, or Project settings → Connectors). All the details are in Google Sheets.

Context sources: for the agent, not your apps

Context sources (Notion, Linear, Figma, Kameleoon) appear on the same page, marked Context for the agent, and under the Used by → The agent filter. The difference matters:

	Connectors (Your apps)	Context sources (The agent)
Who uses it	Your app’s server, for its visitors	The agent, while answering you
When	All the time, in the preview and live	Only when your request refers to it
What’s saved	One key per connection, linked to projects	Your account with the service, for all your projects
Rights	The key’s, on the app’s server	Read-only (Kameleoon: edits possible if you allow them)

A source is connected from its details with the Connect button, and removed with Disconnect. See Context sources.

Good to know

• Keys are never shown again. Once saved, a secret value is no longer visible, neither to you nor to the agent: to change it, replace it. Only public values (for example a measurement ID) are shown in clear under the connection’s name.
• The agent never sees your keys. It only knows whether a key is set, and it can suggest linking a connection you already saved.
• Deleting your account erases all your connections. The keys stay valid at the services themselves: revoke them there too if you no longer use them.

See also

ConnectorsAdd a service to your app, and the full list.

App secretsThe keys read by your app's server.

Project settingsA project's connectors, secrets and backend.

Context sourcesNotion, Linear, Figma and Kameleoon for the agent.