REST


The rest notification platform allows you to deliver RESTful notifications from Home Assistant to another party.

To enable the REST notification in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME
    platform: rest
    resource: http://IP_ADDRESS/ENDPOINT

Configuration Variables

name

(string)(Optional)Setting the optional parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

Default value: notify

resource

(string)(Required)The resource or endpoint that will receive the value.

method

(string)(Optional)The method of the request. Valid options are GET, POST or POST_JSON.

Default value: GET

headers

(string)(Optional)The headers for the request.

message_param_name

(string)(Optional)Parameter name for the message.

Default value: message

title_param_name

(string)(Optional)Parameter name for the title.

target_param_name

(string)(Optional)Parameter name for the target.

data

(string)(Optional)Dictionary of extra parameters to send to the resource.

data_template

(template)(Optional)Template dictionary of extra parameters to send to the resource.

To use notifications, please see the getting started with automation page.