Apps and connections
Teams connect apps and select personal/company accounts. Connecting is separate from syncing.
Teams connect apps and select personal/company accounts. Connecting is separate from syncing.
Where to find it
Web: open Apps. Desktop: Business → Apps, using the same record paths. Disabled modules or missing read permission remove the navigation entry.
| Screen / tab | Web path | Usage | Desktop |
|---|---|---|---|
| Apps | /apps | List, view or tab | Native screen |
| Marketplace | /marketplace | List, view or tab | Native screen |
| Workflow canvas | /marketplace/[id] | Record or editor | Native screen |
| Record details | /apps/[id] | Record or editor | Native screen |
Start working
Step 1
Open catalog app.
Step 2
Complete OAuth/setup.
Step 3
Choose ownership/account.
Step 4
Test/pause/reconnect/disconnect.
Step 5
Browse agent/workflow/skill templates.
Settings
Option-by-option configuration and screen paths: Settings guide.
- Installed apps ·
/settings/apps - Deliveries ·
/settings/apps/deliveries - MCP servers ·
/settings/integrations/mcp
Permissions and limits
Before you start
Connections do not grant all business access. Secrets are replaced in setup rather than read back.
Role capabilities: Read (read), Write (write), Delete/archive (delete), Manage (manage), Handle automated delivery/jobs (handle), Export (export).
Own-record restrictions apply equally to lists, records and Era. Record state or missing data can refuse an otherwise permitted action.
Ask Era
Show connected apps needing reconnection.
Select relevant records for Era context. Era respects modules/roles; external or confirmation-sensitive work can stop for approval. Use era tools in the terminal to inspect currently available tools.
Automation and events
These declared events are available to module-event triggers. Subscribing does not configure the next operation; choose recipients, conditions and actions separately.
Operation details
The inventory includes record, configuration, visitor and background flows. IDs support Era/automation; not every row is a menu button. Asterisks mark required inputs. Unmapped rows do not imply a visible control.
| Operation and ID | Inputs | Permission | Screen or flow |
|---|---|---|---|
Record a connection · apps.connect | Provider *, Name *, Kind *, Where the secret is kept *, Account at the provider, Scopes granted, Expires | Manage | /settings/ai/computer, /settings/apps, /settings/inbox/connect, /tables/[tableId]/sync |
Change a connection · apps.update_connection | Connection *, Name, Where the secret is kept, Account at the provider, Scopes granted, Expires, Status | Manage | /settings/apps |
Disconnect · apps.disconnect | Connection * | Delete/archive | /apps, /settings/ai/computer, /settings/apps |
Record a connection failure · apps.record_failure | Connection *, What the provider said * | Handle automated delivery/jobs | Record/API/visitor flow; no separate screen button mapped |
Register an installation · apps.register_installation | Where it was connected *, Engine row *, Provider *, Name *, Kind *, Account at the provider, Scopes granted | Manage | /apps, /tables/[tableId]/sync |
Pause or resume a connection · apps.set_paused | Connection *, Paused * | Manage | /apps |
Record a passed connection test · apps.record_healthy | Connection * | Handle automated delivery/jobs | Record/API/visitor flow; no separate screen button mapped |
Store a secret · apps.store_secret | Connection, Secret * | Manage | Record/API/visitor flow; no separate screen button mapped |
Record a poll of a connected app · apps.record_poll | Connection *, Feed *, Checkpoint, New items, What the provider said | Handle automated delivery/jobs | Record/API/visitor flow; no separate screen button mapped |
Add a connection · apps.add_connection | App *, Name *, Kind *, Key, Where the secret is kept, Account (e.g. info@…), Whose, Who may use it, Team | Read | /apps |
Change whose a connection is · apps.set_connection_owner | Connection *, Whose *, Who may use it, Team | Read | /apps |
Choose which account to use · apps.set_connection_choice | For *, Which one, App *, Use *, Connection | Read | Record/API/visitor flow; no separate screen button mapped |
Connect WhatsApp Business · apps.connect_whatsapp | Phone number id *, WhatsApp Business Account id *, Business portfolio id, Number *, Display name, Business token *, Two-step PIN, Connected by, Whose, Who may use it, Team | Read | Record/API/visitor flow; no separate screen button mapped |
Refresh a connection’s token · apps.rotate_secret | Connection *, Secret * | Handle automated delivery/jobs | Record/API/visitor flow; no separate screen button mapped |
Related guides
Related integrations
Open a guide for connection fields, account selection and app-specific limits.
Technical sources
packages/os-kernel/src/modules/apps.ts, packages/os-kernel/src/modules/index.ts, apps/studio/lib/os/navigation.ts, apps/studio/lib/os/settings-groups.ts, apps/era-station/apps/web/src/era/business/screens.ts.