# ring_doorbell - Ring doorbell battery

Check the battery level of a Ring doorbell.

device_name
  Type:

    string

  Required:

    true

  the name of the Ring Doorbell to monitor.

minimum_battery
  Type:

    integer

  Required:

    false

  Default:

    `25`

  the minimum battery percent allowed.

username
  Type:

    string

  Required:

    true

  your Ring username (e.g. email address). Accounts using MFA are not supported. You can create a separate user for API access.

password
  Type:

    string

  Required:

    true

  your Ring password.

Warning

Do not commit credentials to source control!

device_type
  Type:

    string

  Required:

    false

  Default:

    `doorbell`

  the device type. Acceptable values are `doorbell` or `camera`.