home-assistant.io/source/_components/sensor.ups.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release	ha_iot_class
page	UPS Sensor	Instructions on how to set up UPS sensors within Home Assistant.	2017-02-14 08:00	true	false	true	true	ups.png	Postal Service	0.39	Cloud Polling

The ups platform allows one to track deliveries by the UPS. To use this sensor, you need a My UPS Account.

{% linkable_title Configuration %}

To enable this sensor, add the following lines to your configuration.yaml:

# Example configuration.yaml entry
sensor:
  - platform: ups
    username: YOUR_USERNAME
    password: YOUR_PASSWORD

Configuration options for the UPS Sensor:

• username (Required): The username to access the UPS My Choice service.
• password (Required): The password for the given username.
• name (Optional): Name the sensor.
• update_inverval (Optional): Minimum time interval between updates. Default is 1 hour. Supported formats:
  • update_interval: 'HH:MM:SS'
  • update_interval: 'HH:MM'
  • Time period dictionary, e.g.:

    update_interval:
        # At least one of these must be specified:
        days: 0
        hours: 0
        minutes: 3
        seconds: 30
        milliseconds: 0
    

The UPS sensor logs into the UPS My Choice website to scrape package data. It does not use an API. Use at your own risk.

If the UPS sensor is throwing an error about not being able to login to the UPS My Choice website, it's likely because there is a new UPS Technology Agreement (UTA) preventing the scraper from accessing the package data. Login to UPS My Choice manually and accept the UTA to resolve this.