Connector connection modes
Choose who owns a connector account and where Swarmz can use it
A connection mode decides whose provider account an app uses. Choose the mode before you connect an account; the choice changes the data boundary and the code Swarmz generates.
| Mode | Account owner | Use it for |
|---|---|---|
| Shared project connection | A builder or workspace administrator | One team Slack workspace, CRM, database, or delivery account used by the project |
| Published app user | Each signed-in user of the published app | Personal files, calendars, messages, or provider workspaces that must stay separate per app user |
| Chat context | The builder | Reference material used while building, but not automatically available to the published app |
Shared project connections
The builder authorizes one provider account. Swarmz encrypts the credential, links the selected connection to the project, and gives generated server code a project gateway key. The code calls the connector gateway; it never receives the provider token.
Use a shared connection when everyone using the app should act through the same provider identity. For example: “Post new signups to our #sales Slack channel.”
Published app-user connections
Each signed-in app user authorizes their own account. The generated server handler derives that user's ID from the app session, then calls Swarmz. Swarmz stores a one-way project-specific subject hash instead of the raw app user ID.
Use this mode when one user's provider data must not be visible to another user. For example: “Let each customer connect their own Notion workspace.”
See Connect accounts for published app users for the setup and server boundary.
Chat context
Chat context helps the AI inspect source material while it builds. It is not a runtime connection for the published app. If the app itself must read or write provider data, use a shared or published app-user connection instead.
How the AI chooses
State who owns the account in your prompt:
- “Use our HubSpot account” means shared.
- “Let every user connect HubSpot” means published app user.
- “Read my Notion specification while you build” means chat context.
If ownership is unclear and would change the data boundary, the AI asks you to choose. It must not silently substitute a shared account for a per-user request.
Availability
A connector appears only when an administrator has enabled it. OAuth connectors also require an active OAuth application in the Swarmz admin or the Platform account. Disabling a connector blocks new setup. Existing connections remain available for reconnect, disconnect, and removal.