Source: https://spooly.eu/en/docs/home-assistant/configuration

# Setup

You start the setup like for any integration and then choose between signing in with a click and a key.

## Start the setup

Settings, Devices & services, “Add integration”, Spooly. Or directly with the button:

[Set up directly](https://my.home-assistant.io/redirect/config_flow_start/?domain=spooly)

## Sign in with Spooly

1. Choose “Sign in with Spooly”. Spooly opens in a new window.
2. Spooly shows what Home Assistant may read. “Also allow changes” is preselected because the actions need it.
3. Click “Allow”. Back in Home Assistant the integration creates the devices.

Home Assistant never sees your password. The redirect back runs through My Home Assistant.

## With a key

1. Create a key in Spooly in the browser: Settings, Devices & keys, type Home Assistant. If Home Assistant should be allowed to change things, switch on “May also change”.
2. In Home Assistant choose “Enter a key” and enter it. It starts with `spk_`.

## Fields during setup

| Field | Meaning |
| --- | --- |
| How do you want to connect Home Assistant with Spooly? | “Sign in with Spooly” or “Enter a key” |
| API key | Only with a key. Starts with `spk_`. |
| Advanced, API address | Collapsed, default `https://spooly.eu/api/v1`. Only change it for a test environment, the address has to start with `https://`. |

## Options after setup

There are none. What Home Assistant shows, you set in Spooly, for example the thresholds for low spools.

## Signing in again

If you revoke the connection in Spooly or the permission to change is missing, Home Assistant offers to sign in again. A Spooly account can only be set up once. If you sign in with a different account while renewing, Home Assistant aborts.