Connectors & Service Connections

Use Connectors to connect an external service, reconnect an expired calendar or email connection, or manage more than one account for a service.

Open Connectors

Open Settings → Integrations → Connectors. The page lists services you can connect or manage.

Use Filter connectors to find a service by name or description. You can sort the list by Relevance, Name, or Recently connected.

To add or manage secrets, go to Settings → Integrations → Secrets.

Connect a service

To make an account available in Obvious:

1. Open Settings → Integrations → Connectors.
2. Find the service you need and select Connect directly on its card.
3. When the detail panel opens, select + Connect to add an account.
4. Complete the setup requested for that service.

Connection setup depends on the service. Some services ask you to authorize access in a sign-in window, while others ask for an API key or other connection details. Follow the prompt shown for the service you selected.

If an authorization window is expected but does not open, allow popups for app.obvious.ai, then try the connection again.

Connect another account for the same service

A connected service shows Manage on its card. To connect another account:

1. Select Manage on the connected service card to open its detail panel.
2. Under Connected accounts, select + Connect.
3. Complete the setup requested for the additional account.

Reconnect an expired connection

When a calendar or email connection expires, the account row shows Connection expired beneath the account name or email address.

Reconnect the account without disconnecting it first:

1. Open Settings → Integrations → Connectors.
2. Find the affected service and select Manage.
3. Find the account marked Connection expired and open its actions menu.
4. Select Reconnect, then follow the authorization steps shown for that account.

Add a secret

Secrets has its own page at Settings → Integrations → Secrets. To add a secret:

1. Open Settings → Integrations → Secrets.
2. Select Add secret.
3. Enter the secret Name and Value.
4. If the form shows Available to, choose who may use the secret.
5. Select Add secret to save it.

Secret names must begin with a letter and use uppercase letters, numbers, or underscores, such as STRIPE_API_KEY. After the secret is saved, Obvious confirms Secret created successfully.

Change who can use a connection

You can update the availability of an existing account connection from its detail panel.

1. On the Connectors page, open a connected service by selecting Manage or its card.
2. In the connection row, open the actions menu and select Edit.
3. Under Available to, choose the availability you want.
4. Select Save changes.

Available choices can include Only me and Workspace members. Team members appears when teams are available, and Project members appears when projects are available.

Disconnect a connection

Before disconnecting an account, check whether you still need it for work that uses that connection. Removing it means Obvious cannot use that connected account again unless you reconnect it.

To disconnect:

1. Open Settings → Integrations → Connectors and select the connected service.
2. In the row for the account you want to remove, open the actions menu.
3. Select Disconnect.

When the removal succeeds, Obvious confirms Connector disconnected. If work depends on the removed connection, reconnect the account or update that work to use another available connection.