DocsHome AssistantOpen the appDE

spooly.eu/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.

Open as text
On this page

Start the setup

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

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

FieldMeaning
How do you want to connect Home Assistant with Spooly?“Sign in with Spooly” or “Enter a key”
API keyOnly with a key. Starts with spk_.
Advanced, API addressCollapsed, 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.