CAP

1. Create a new playlist that should be activated when a CAP alert is triggered.
2. Add the “CAP alert” plugin to the slide. Design the slide and select whether the description or the headline of the alert is inserted into the placeholder when the alert is triggered.
3. Tag the screens on which the alert should be shown. When you click “edit” on the tag, you will see the Tag ID.
4. Create a new API key on the Teams page (note down the API key).
5. The tag can now be triggered through the API: https://api.playsignage.com/docs#tag/Tag/paths/1v11tags1%7Bid_tag%7D1alert/post
6. Depending on your region, the base URL is either https://eu-api.playsignage.com or https://us-api.playsignage.com

Testing the alert trigger is more technical, because you need to imitate the request an alert service provider would send. The example below uses curl, which works on macOS and Linux. On Windows, you can use a program called Postman. Replace the URL (the example uses us-api), tag_id and api_key with your own values. Also update the effective, onset and expires dates in the payload, so the alert is within its active window when it is triggered.

 curl -X POST "https://us-api.playsignage.com/v1/tags/<tag_id>/alert" \
     -H "Content-Type: application/xml" \
     -H "Authorization: <api_key>" \
     -d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
    <identifier>ALERTUS_3716_164_20260302_203832</identifier>
    <sender>PlaySignage Test</sender>
    <sent>2026-03-07T19:00:00+00:00</sent>
    <status>Actual</status>
    <msgType>Alert</msgType>
    <source>Alertus eEAS Server</source>
    <scope>Public</scope>
    <addresses>ALL</addresses>
    <code>IPAWSv1.0</code>
    <info>
        <language>en-US</language>
        <category>Safety</category>
        <event>Local Area Emergency</event>
        <responseType>None</responseType>
        <urgency>Immediate</urgency>
        <severity>Severe</severity>
        <certainty>Observed</certainty>
        <eventCode>
            <valueName>SAME</valueName>
            <value>LAE</value>
        </eventCode>
        <effective>2026-03-07T19:00:00+00:00</effective>
        <onset>2026-03-07T20:00:00+00:00</onset>
        <expires>2026-03-07T20:00:00+00:00</expires>
        <headline>HEADLINE This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</headline>
        <description>DESCRIPTION This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</description>
        <parameter>
            <valueName>EAS-ORG</valueName>
            <value>EAS</value>
        </parameter>
        <area>
            <areaDesc>Not specified</areaDesc>
            <geocode>
                <valueName>SAME</valueName>
                <value>000000</value>
            </geocode>
        </area>
    </info>
</alert>'

To cancel an ongoing alert:

 curl -X POST "https://us-api.playsignage.com/v1/tags/<tag_id>/alert" \
     -H "Content-Type: application/xml" \
     -H "Authorization: <api_key>" \
     -d '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<alert xmlns="urn:oasis:names:tc:emergency:cap:1.2">
    <identifier>ALERTUS_3716_164_20260302_203832_CANCEL</identifier>
    <sender>PlaySignage Test</sender>
    <sent>2026-03-07T19:00:00+00:00</sent>
    <status>Actual</status>
    <msgType>Cancel</msgType>
    <source>Alertus eEAS Server</source>
    <scope>Public</scope>
    <addresses>ALL</addresses>
    <code>IPAWSv1.0</code>
    <info>
        <language>en-US</language>
        <category>Safety</category>
        <event>Local Area Emergency</event>
        <responseType>None</responseType>
        <urgency>Immediate</urgency>
        <severity>Severe</severity>
        <certainty>Observed</certainty>
        <eventCode>
            <valueName>SAME</valueName>
            <value>LAE</value>
        </eventCode>
        <effective>2026-03-07T19:00:00+00:00</effective>
        <onset>2026-03-07T20:00:00+00:00</onset>
        <expires>2026-03-07T20:00:00+00:00</expires>
        <headline>This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</headline>
        <description>This is a TEST of the Alertus Emergency Notification system.  NO ACTION IS NEEDED.  In a real emergency, this message will contain important alert information.</description>
        <parameter>
            <valueName>EAS-ORG</valueName>
            <value>EAS</value>
        </parameter>
        <area>
            <areaDesc>Not specified</areaDesc>
            <geocode>
                <valueName>SAME</valueName>
                <value>000000</value>
            </geocode>
        </area>
    </info>
</alert>'