# salt.states.pushover

## Send a message to PushOver

This state is useful for sending messages to PushOver during state runs.

New in version 2015.5.0.

    pushover-message:
      pushover.post_message:
        - user: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        - token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        - title: Salt Returner
        - device: phone
        - priority: -1
        - expire: 3600
        - retry: 5
        - message: 'This state was executed successfully.'

The api key can be specified in the master or minion configuration like below: .. code-block:: yaml

> pushover:

>   token: peWcBiMOS9HrZG15peWcBiMOS9HrZG15

salt.states.pushover.post_message(name, user=None, device=None, message=None, title=None, priority=None, expire=None, retry=None, sound=None, api_version=1, token=None)

  Send a message to a PushOver channel.

      pushover-message:
        pushover.post_message:
          - user: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
          - token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
          - title: Salt Returner
          - device: phone
          - priority: -1
          - expire: 3600
          - retry: 5

  The following parameters are required:

  name

    The unique name for this event.

  user

    The user or group of users to send the message to. Must be ID of user, not name or email address.

  message

    The message that is to be sent to the PushOver channel.

  The following parameters are optional:

  title

    The title to use for the message.

  device

    The device for the user to send the message to.

  priority

    The priority for the message.

  expire

    The message should expire after specified amount of seconds.

  retry

    The message should be resent this many times.

  token

    The token for PushOver to use for authentication, if not specified in the configuration options of master or minion.