Home Assistant

With the SinricPro Home Assistant integration you can control your Sinric Pro devices from Home Assistant and use them in Home Assistant automations.

Configuration from the Home Assistant UI. No YAML required.
Real-time state updates.
Sinric Pro alerts appear as Home Assistant notifications.

1. Get an API Key

If you do not have a API Key, Login to Portal and click Credentials or click here to generate a new API key.

Copy the API Key. This is not the App Key used in your device code.

2. Install the integration

With HACS (recommended)

Open HACS in your Home Assistant instance.
Click on Integrations.
Click the three dots in the top right corner and select Custom repositories.
Add the repository URL: https://github.com/sinricpro/homeassistant-sinricpro
Select Integration as the category and click Add.
Search for SinricPro and install it.
Restart Home Assistant.

Manually

Download the latest release from the releases page.
Copy the custom_components/sinricpro folder into the custom_components directory of your Home Assistant configuration.
Restart Home Assistant.

3. Add your Sinric Pro account

Go to Settings > Devices & Services.
Click + Add Integration.
Search for SinricPro.
Enter your Sinric Pro API key and click Submit.

Your Sinric Pro devices now appear in Home Assistant.

Supported devices

Sinric Pro device type	Home Assistant platform	Features
Switch	`switch`	On/Off
Light	`light`	On/Off, brightness, RGB colour, colour temperature
Dimmable Switch	`light`	On/Off, power level. Appears as a dimmable light
Blinds	`cover`	Open/Close, position
Garage Door	`cover`	Open/Close
Doorbell	`event`, `button`, `sensor`	Press event, manual trigger, last ring time
Fan	`fan`	On/Off, speed
Smart Lock	`lock`	Lock/Unlock
Speaker	`media_player`	On/Off, volume, mute
TV	`media_player`	On/Off, volume, mute, channel up/down, play/pause
Thermostat	`climate`	On/Off, target temperature, mode, current temperature, humidity
Window AC Unit	`climate`	Thermostat features and fan mode
Air Quality Sensor	`sensor`	PM1.0, PM2.5, PM10
Contact Sensor	`binary_sensor`	Open/Closed
Motion Sensor	`binary_sensor`	Motion detected / not detected
Temperature Sensor	`sensor`	Temperature, humidity

Custom device types made with device templates are not supported yet.

Use Sinric Pro alerts in automations

The integration fires a sinricpro_alert event for every Sinric Pro alert. Example:

automation:
  - alias: "SinricPro Alert Notification"
    trigger:
      - platform: event
        event_type: sinricpro_alert
    action:
      - service: notify.mobile_app
        data:
          message: "{{ trigger.event.data.message }}"

Troubleshooting

“Invalid API key” error

Make sure you use the API key from the Credentials page of the Portal, not the App Key.
Check that the API key has not expired.

Devices not appearing

Check that the devices exist in your Sinric Pro account and are online in the Portal.
Reload the integration.

State not updating

Check your network connection and the Home Assistant logs for connection errors.

To enable debug logging, add the following to your configuration.yaml:

logger:
  default: info
  logs:
    custom_components.sinricpro: debug

If the problem continues, open an issue on GitHub.

This document is open source. See a typo? Please create an issue