Each application, service, or utility that sends notifications through Pushover's API needs to have its own API token which uniquely identifies all of the API requests that it makes.  A single API token can be used to send to multiple Pushover User Keys.

API tokens are free and can be registered through our website.

Please note that while API tokens can be used to send to multiple users, any API tokens you register should be protected and not disclosed to any other users or given to any 3rd party services.

Pushover's API is designed to be easy to use without the overhead of complicated authentication mechanisms like OAuth.  For full details on our API endpoints, see our API Documentation.

To quickly get started sending Pushover messages with a wide variety of programming languages, we have some sample code as well as a number of 3rd party libraries written and maintained by Pushover users.

In all of these examples, replace USER_KEY with your Pushover User Key (which can be found on your dashboard) or that of the user/group to which you are sending, and API_TOKEN with your application's API Token.  If

Pushover messages are delivered to your devices by supplying your Pushover User Key to any Apps and Services that support Pushover.  To send messages to an additional user's devices at the same time, you can create a Delivery Group and add each user to the group, and then supply that new Group Key to those Apps and Services instead of your own User Key.

Note: for companies and organizations that require centralized management of multiple accounts, please see our Pushover for Teams service which greatly simplifies sending messages to multiple users.

Creating a Delivery Group

To create a Delivery Group, login to

Pushover Subscriptions are a great way to add other Pushover users to a Delivery Group to be able to broadcast messages to them, all without having to manually collect Pushover User Keys.  Subscribed users can also unsubscribe from your notifications at any time in the future without any effort required on your part.

By creating a Group-based Subscription, users can visit a URL that we create for your application and choose to subscribe to notifications from your application.  Once subscribed, the user will be added to a Delivery Group with a single-use User Key that is deleted as soon as

Each application registered to send Pushover notifications may send 10,000 messages per month for free, where one message is defined as successfully sending a message through our API to one user, regardless of the number of devices on their account. For Delivery Groups, each user in the group receiving that message counts as one message towards the application's quota.

One application assigned to a Team can send up to 25,000 messages per month for free. All other applications can send the usual 10,000 amount for free.

To send more than the free amount of messages per month, upgrade packages are

On the first of each month at midnight Central Time, all application usage limits reset back to the free allowance of 10,000 messages. Once an application has sent 10,000 messages in a month, it will receive an error from our API and will no longer be able to send messages until the first of the next month when the allowance resets.

For high-volume applications that need to send more than 10,000 messages per month, additional capacity can be purchased from our website (10,000 for $50.00 USD, 25,000 for $115.00 USD, 50,000 for $200.00 USD, 100,000 for $300.00 USD, 500,000 for

To send multi-line notifications with line-breaks, send regular newline ("\n", ASCII 10) characters in your message. Your library or programming language may not interpret "\n" characters properly inside strings and may send them as a literal backslash and "n". In those cases, you may need to use your language's chr() or similar function to represent a single character with ASCII value 10.

When using curl in shell scripts, you may find it easiest to just insert literal line breaks in your file:

Pushover's Featured Public Applications page provides our users with a list of applications, plugins, websites, and services that provide Pushover support and integrate with our API.

To get your application listed, it must follow these guidelines:

• The resource must be publicly available (i.e., not an internal company application). You may charge money for the app, plugin, or service, but you cannot charge extra for Pushover functionality.
• For externally hosted services, you must use one API token per service/application and you are responsible for purchasing additional capacity as needed. You may not register multiple API token to get around our message

Each application that uses Pushover's API must be registered to receive its own API token. For most users, this API token will be kept secret in your own application, script, or website and you will be able to monitor and restrict its use.

For those distributing software that is installed and managed by your end-users, such as libraries and open source projects that use Pushover's API, each user must register their own application and then enter that unique API token in their copy of your software. This way each user will get their own monthly quota of messages without being