Connections

​

Overview

A connection is a saved link between nuwacom and an external tool. Connecting a tool such as Google Calendar, HubSpot, or Slack creates a connection that stores the access needed to work with that service. Each connection belongs to the person who created it. By default it is private: only the owner can see and use it, and actions run with the owner’s own access rights in the external service.

​

Authentication Types

How you connect depends on the Connector.

​

OAuth

Most popular Connectors use OAuth, the industry-standard protocol for secure authorization:

1. nuwacom sends you to the service’s login page, for example Google or Microsoft.
2. Sign in with your own account.
3. Approve the requested permissions.
4. nuwacom stores the access securely.

The connection acts on your behalf. If you cannot open a calendar in Google, an agent using your connection cannot open it either.

​

API key / token

Some Connectors, especially custom ones, are set up with an API key or token. Copy it from the service’s settings and paste it into nuwacom when connecting.

---

​

Reconnecting

If a connection has expired or been revoked, its account shows a warning icon with the note Connection issue. Reconnect the account to restore access.

---

​

Who Can Use a Connection

​

Private by default

A new connection is shown as Private account:

1. Only the owner can see and use it.
2. Actions run with the owner’s access rights.
3. Credentials are never shown to other users.

​

Sharing an account

The owner can share an account from Settings → Connectors:

1. Find the account in the list.
2. Select the share icon next to it (Share {account name}).
3. Choose who gets access: specific users, user groups, or all workspace users.

Shared accounts are labeled Shared account. Sharing with the entire workspace is available if your role allows sharing with the workspace. Share an account only with people you trust to act through it. Everyone with access works with the owner’s permissions in the external service.

---

​

Using a Default Account in an Agent

You can let other people run a Connector action with a specific account without sharing the account itself. They can use it only through the agent. They never see its credentials.

​

Configure it

1. Open Agents in the sidebar and open or create an agent.
2. In Actions, select Add action and choose the Connector action.
3. Select Select default account.
4. Choose the account and select Add action.
5. Publish the agent and share it with the people who should use it.

​

The two modes

1. Select default account: One account is used for everyone who runs the action. Whatever the user’s own accounts are, the action runs with this account’s access.
2. Every user must use their own account (advanced): Each person uses their own account. People who have not connected yet are asked to connect.

​

Examples

• Default account: A “Team Calendar Agent” uses a shared team calendar. When any colleague uses it, the event lands in the team calendar.
• Own account: A “Personal Email Agent” sends mail from each user’s own mailbox, using their own connection.

If no account is selected for an action, every user has to connect their own account when using the agent.

---

​

Apps

Apps always run with the connected accounts of the person who opens them. Your own connected accounts stay private and are never used by people you share an app with.

---

​

Choosing the Right Approach

​

FAQ