Share911 Help Center

Broadcast REST API


Share911 accepts requests to broadcast alerts via our REST API.  

In order to use the API your user account will need 2 things:

  • Broadcast Alert permission
  • An API key

To receive your API key, please contact



REST Endpoint: ""

NOTE: Visiting this URL through a browser will not allow broadcasts to be sent. This URL is only for REST calls.


Basic authentication. The username is always "api". The password is the API key provided by Share911 Support.


The REST request should include data in JSON format.  The fields are:


Channel ID of the target communication channel.  The easiest way to find the Channel ID is on the Manage Channel => Channel Info page, under either Channel ID or Share ID.  You can also find the Channel ID by looking in the URL. For example, if I select the East Branch channel in Share911, the Channel ID is the "sharevilledemo/eastbranch" part of the URL:


The name of the alert to broadcast.  This should match one of the alert types in the "Currently Selected Alerts" list under the Manage Channel => Broadcasting => Select Alerts page.


An optional message to include in the broadcast, in string format.


Alert recipients.  Requests via API would usually be broadcast to all members on the channel, like so:


Contact to customize recipients.



curl -X POST --user 'api:<YOUR API KEY>' \ \
    -H "Content-Type: application/json" \
    -d '{
          "channelId": "<CHANNEL ID>",
          "type": "<ALERT TYPE>",
          "msg": "<MESSAGE>",
          "to": {"channelGroups":"ALL_USERS"}


curl -X POST --user 'api:91567870-ffa6-4665-8188-ca0a4b820a21' \ \
    -H "Content-Type: application/json" \
    -d '{
          "channelId": "sharevilledemo/eastbranch",
          "type": "LOCKDOWN",
          "msg": "Martians Attacking!",
          "to": {"channelGroups":"ALL_USERS"}


curl -X POST --user 'api:91567870-ffa6-4665-8188-ca0a4b820a21' \ \
    -H "Content-Type: application/json" \
    -d '{
          "channelId": "sharevilledemo/eastbranch",
          "type": "ALL CLEAR",
          "msg": "",
          "to": {"channelGroups":"ALL_USERS"}


* Repeated alert requests are ignored.  So if there is already an active LOCKDOWN then requesting another LOCKDOWN will not work.  But you can broadcast a different alert, such as an EVACUATE or SHELTER IN PLACE.

* Request an ALL CLEAR broadcast to clear a channel of past activity.  Activity can be reviewed via the After Action report.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.

Related Articles