App guides

How to Use WakeUp 2day With Home Assistant

WakeUp 2day connects to Home Assistant with two things: your Home Assistant URL and a long-lived access token. That single connection lets alarms, sleep events and schedules control your lights, climate devices and locks, and lets WakeUp read a CO₂ sensor while you sleep. Automations need WakeUp Pro; CO₂ monitoring is free.

Key takeaways

  • One Home Assistant connection serves lights, climate, locks and CO₂ monitoring in WakeUp 2day.
  • You need your Home Assistant URL and a long-lived access token from your user profile.
  • Alarms can run light, climate and lock actions in order, and sleep events and schedules work too.
  • Automations need WakeUp Pro; CO₂ monitoring through Home Assistant is free.
  • Use an https address if you can, because over http the token is sent unencrypted.

What you get from one connection

Home Assistant can supply every kind of device WakeUp works with, through a single connection that the Smart Lights, Climate Control, Smart Locks and Air Quality settings share:

  • Lights: WakeUp discovers your light entities for the Wake-up Light, per-alarm light actions, Sleep Dim and light schedules.
  • Climate: WakeUp discovers thermostats and AC units for climate actions, events and schedules.
  • Locks: lock entities can be locked or unlocked by alarms, sleep events and schedules.
  • CO₂: a CO₂ sensor can be recorded every 30 minutes during sleep tracking.

It is a good fit if you already run Home Assistant and want your alarm, rather than a fixed time, to start the morning. For ideas on what to automate, see building a morning routine that starts with your alarm.

What you need

  • A running Home Assistant that your iPhone can reach, usually on your home network.
  • Its URL, such as the http://homeassistant.local:8123 example the app shows, or your own https address.
  • A long-lived access token, created from your Home Assistant user profile.
  • WakeUp Pro for light, climate and lock automations. CO₂ monitoring is free, and you can connect Home Assistant for it in Settings > Sleep & Health > Air Quality without Pro.

How to connect Home Assistant

  1. Create a token. Open Home Assistant in a browser, click your profile icon at the bottom left and find Long-Lived Access Tokens (in recent versions, on the Security tab). Create a token, name it something like WakeUp, and copy it. Home Assistant shows it only once.
  2. Open Smart Lights. In WakeUp, go to Settings > Smart Home > Smart Lights, turn on Smart Lights and choose Home Assistant as the Light System.
  3. Enter the details. Fill in Home Assistant URL, paste the token into Long-Lived Access Token and tap Connect.
  4. Choose your lights. WakeUp discovers your light entities. Under Lights, pick rooms and groups or individual lights, or leave the selection empty to control all of them.
  5. Add climate and locks. Open Climate Control and Smart Locks in Settings > Smart Home and choose Home Assistant. Each shows “Home Assistant connected via Smart Lights”, so you only need to load your devices and select the ones to control.
  6. Add a CO₂ sensor if you have one, in Settings > Sleep & Health > Air Quality.

You can also start from Climate Control or Smart Locks; connecting there enables Home Assistant for Smart Lights as well.

Using Home Assistant with alarms, sleep and schedules

Per-alarm actions. In the alarm editor, the Automations section offers Light Action, Climate Action and Lock Action. Lights can turn on or off, flash or set a color and brightness; climate devices can turn on or off or go to a set temperature; locks can lock or unlock. Tap Add Action to build a sequence. Actions run in order when the alarm rings.

Wake-up defaults. An alarm with no automations of its own uses the Wake Up settings for lights, climate and locks in Settings > Smart Home, such as the Wake-up Light.

Sleep events. Climate and lock actions can run on Fall Asleep, Wake Up and Timer, and Sleep Dim dims your lights when sleep tracking starts. Fall Asleep and Timer rely on sleep tracking that night.

Schedules. Light, climate and lock schedules run at set times, independent of alarms. Locks and climate are covered in more detail in automating locks and climate around your sleep.

Tips

  • Prefer https. The app points out that http works on your home network but sends the token unencrypted, so use https if your Home Assistant supports it.
  • Give WakeUp its own token. A dedicated token can be revoked in Home Assistant without affecting anything else.
  • Keep WakeUp on screen overnight. If an alarm rings on the Lock Screen, lights and climate run when you stop or snooze it. Starting sleep tracking at bedtime keeps WakeUp open, so they run with the alarm.
  • Add air quality. If a CO₂ sensor already reports to Home Assistant, monitoring bedroom CO₂ while you sleep reuses the same connection and is free.

Troubleshooting

  • “Connection failed. Check the URL and token.” Copy the token again in full, and check that the URL starts with http:// or https:// and includes the port if your setup uses one.
  • “Cannot reach Home Assistant.” Make sure your iPhone is on a network that can reach it (a local address does not work over mobile data) and that Local Network access is allowed for WakeUp in the iOS Settings app under Privacy & Security > Local Network.
  • Devices are missing: after adding entities in Home Assistant, tap Refresh Lights, or load the climate and lock devices again.
  • No Automations section in an alarm: it needs WakeUp Pro and a connected light, climate or lock system.
  • A morning lock action did not run: the Wake Up lock settings run only when the alarm rings in WakeUp. An alarm’s own Lock Action runs either way, so add it to the alarm if it must always happen.

Where to start this week

Create a token, connect Home Assistant under Smart Lights and give one alarm a single light action. Run a test alarm a few minutes ahead with WakeUp open, then add a climate or lock step once the lights behave. If your Hue lights are not in Home Assistant, connecting Philips Hue directly to your alarm covers that route.

Frequently asked questions

How do I create a long-lived access token in Home Assistant?

Open Home Assistant in a browser, click your profile icon at the bottom left and find the Long-Lived Access Tokens section; in recent versions it sits on the Security tab of your profile. Create a token, give it a name such as WakeUp, and copy it straight away, because Home Assistant shows it only once.

Can my iPhone alarm control Home Assistant devices?

Yes. Once Home Assistant is connected to WakeUp 2day, each alarm can turn lights on or off, set their brightness and color, switch climate devices or set a temperature, and lock or unlock doors when it rings, in the order you choose. These automations need WakeUp Pro. If the alarm rings on the Lock Screen, lights and climate run when you stop or snooze it.

Does WakeUp 2day work with Home Assistant away from home?

WakeUp connects to Home Assistant at the URL you enter. A local address such as homeassistant.local works only while your iPhone is on your home network, which is usually where you are when an alarm rings or you track your sleep. Whatever address you use, prefer https if your setup supports it, because over plain http the token is sent unencrypted.

Where does WakeUp 2day store my Home Assistant token?

In the iOS Keychain, not in the app’s own files, and it is used only to talk to the Home Assistant address you entered. If iCloud Keychain is on, iOS syncs it to your other devices, end-to-end encrypted. WakeUp has no account and sends nothing to its developer. You can revoke the token in Home Assistant whenever you like.