Skip to main content
Auth connections let your HTTP tools authenticate against external services — for example an API protected by a bearer token, basic auth, or a custom header. Set up a connection once and reuse it across the tools that need it. Open Settings → Auth connections to manage them.
Managing auth connections requires the Owner or Admin role.

​
How it works

Each connection pairs an authentication method with a value stored as a secret, so the sensitive credential is never exposed in your tool configuration. homie supports:
  • Bearer token — sends an Authorization: Bearer header with your token.
  • Basic auth — sends a username and password.
  • Header — sends a custom header with your value.

​
Add a connection

1

Store the credential as a secret

First add the API key, token, or password as a secret so the value stays encrypted.
2

Open Auth connections

Open Settings → Auth connections and select Add auth connection.
3

Choose the connection type

Select how the external service authenticates — Bearer token, Basic auth, or a custom Header — and reference the secret that holds the value.
4

Use it in an HTTP tool

Reference the connection when configuring an HTTP tool so the tool can call the external service on your behalf.
Bildschirmfoto 2026 07 07 Um 15 10 42

​
Manage connections

Review your connections, update the credential a connection uses, or remove a connection you no longer need. Removing a connection stops any HTTP tool that depends on it from authenticating.

​
Next steps

HTTP Tool

Build tools that call your external services.

Secrets

Store the encrypted credentials your connections use.