Pura for Home Assistant

Home Assistant integration for Pura smart fragrance diffusers.

⬇️ Installation

HACS (Recommended)

This integration is available in the default HACS repository.

1. Use the My Home Assistant badge above, or from within Home Assistant, click on HACS
2. Search for Pura and click on the appropriate repository
3. Click DOWNLOAD
4. Restart Home Assistant

Manual

If you prefer manual installation:

1. Download or clone this repository
2. Copy the custom_components/pura folder to your Home Assistant custom_components directory
3. Restart Home Assistant

⚠️ Manual installation will not provide automatic update notifications. HACS installation is recommended unless you have a specific need.

➕ Setup

Once installed, you can set up the integration by clicking on the following badge:

Alternatively:

1. Go to Settings > Devices & services
2. In the bottom-right corner, select Add integration
3. Type Pura and select the Pura integration
4. Follow the instructions to add the integration to your Home Assistant

🚨 Troubleshooting

If you created your Pura account using one of the third-party provider options (e.g., Apple, Facebook, Google), you will need to set a password on your account before using this integration. You will still be able to use your third-party provider sign in with the Pura mobile app or on pura.com. To do so, follow these steps in the Pura mobile app:

1. Open the Pura app, go to the Settings tab and note your email address.
2. Scroll down and sign out of the app.
3. On the login screen, click Sign into your account.
4. Click on Forgot your password?.
5. Enter the email from step 1 and click Send code.
6. Follow the steps in the Pura app to set your new password (check your email, enter the verification code and create your password). If you didn't receive a verification code, check your spam folder or request a new code.
7. Once you have successfully set a password, follow the configuration steps above.

🎬 Actions

The following custom actions are available:

start_timer

Start a fragrance timer.

Field	Required	Type	Default	Description
area_id*	No	Area	None	The area(s) to target. If an area is specified, all Pura devices in that area will be targeted. (e.g., living_room).
device_id*	No	Device	None	The device(s) to target, filtered by Pura models.
slot	No	Select	None	The slot ("1" or "2") of an available fragrance. Leave blank to automatically select the fragrance with the most scent remaining.
intensity	Yes	Number	4	The intensity of the fragrance. 1 is the lowest (subtle), and 10 is the highest (strong).
duration	Yes	Duration	00:30:00	How long the diffuser should run for.

* - Either an area_id with Pura devices or a valid Pura device_id must be supplied or an error will occur.

Example:

action: pura.start_timer
data:
  device_id:
    - <device-id>
  slot: "1"
  intensity: 9
  duration:
    hours: 0
    minutes: 30
    seconds: 0

---

❤️ Support Me

I maintain this Home Assistant integration in my spare time. If you find it useful, consider supporting development:

• 💜 Sponsor me on GitHub
• ☕ Buy me a coffee / beer
• 💸 PayPal (direct support)
• ⭐ Star this project
• 📦 If you’d like to support in other ways, such as donating hardware for testing, feel free to reach out to me

If you don't already own a Pura diffuser, please consider using my referral code (JG5JN31) to get $20 off your first order of $50+ (as well as a tip to me in appreciation)!

📈 Star History