DocsIntegrationsHome Assistant

Home Assistant

HTTP auth set up for Home Assistant, so a workflow can turn on a light, run a script or read a sensor through its REST API.

CategoryHTTP
Used byCall a URL node
Secret fields1
TestYes

Set it up

  1. In Home Assistant, open your profile, then Security › Long-lived access tokens › Create token.
  2. Add a Home Assistant integration with your instance's address, like your Nabu Casa URL, and the token.
  3. Press Test. It says which instance answered.
  4. In a Call a URL node, pick it and call, say, POST /api/services/light/turn_on with { "entity_id": "light.porch" }.

Fields

FieldRequiredWhat it is
AddressbaseUrlYesYour instance, reachable from the internet over HTTPS.
Access tokentokensecretYesThe long-lived token. Home Assistant only takes bearer tokens.

Secret fields are encrypted as soon as you save them and never shown again: the console shows their last four characters so you can tell which one is saved. Replace one to rotate it; workflows pick up the new one on their next step.

Test it

Calls /api/config, which needs a valid token, and shows the instance's name.

Problems you might see

CodeMeans
INTEGRATION_AUTH_FAILEDHome Assistant refused the token.
INTEGRATION_UNREACHABLEThe address can't be reached from the internet.

Codes starting INTEGRATION_ come from saving or testing. Every other integration code is on the error codes page.