# Auth Connections

Toolhouse AI workers can connect to services and product you use, but only if you give them explicit authorization. These authorizations are called **Auth Connections.**

* Auth Connections are managed by Toolhouse for you. They using an industry-standard, secure mechanism called OAuth.
* AI workers only get access to the services they need. For example, if you authenticated Slack, Gmail, and HubSpot, but the worker only needs Slack, the worker will not be able to access Gmail and HubSpot.
* You can update or remove any connections at any time.
* AI workers will use your own connections. If you share a worker with your team, they will still use your own connections. To use separate connections, you can make a copy of your agent and transfer it to your team.
* Currently, each Toolhouse account can manage one auth connection per service. In other words, if you have two Gmail accounts, you can only use authenticate one.

## Add a new Auth Connection

Agent Builder will prompt you to connect an integration via Auth Connections automatically. Simply click Connect and follow the instructions.

## Manage Auth Connections

The [Auth Connections](https://toolhouse.app/auth-connections) page allows you to update its auth settings or to remove it completely:

* Updating auth settings allows you to switch to another account for the same service, or to reconnect Toolhouse to your service if needed.
* Removing an auth connection will prevent AI workers from communicating to that service.

{% hint style="danger" %}
**Be careful when removing auth connections.** AI workers who rely on a connection will stop working.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.toolhouse.ai/toolhouse/toolhouse/auth-connections.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.