Property Protect Quickstart

Authenticate

First, exchange your client ID and client secret for a secure bearer token. Include this token in the header of all subsequent API calls.

• Reference: Exchange credentials for a token

1
POST /panic-api/v2/oauth/token HTTP/1.1
2
Host: staging-panic.aura.services
3
Content-Type: application/json
4
5
{
6
  "clientId": "your_client_id",
7
  "clientSecret": "your_client_secret"
8
}

Register a Fixed Location

Before you can create a callout for a property, register it as a Fixed Location with coordinates, details, and your own stable externalReferenceId.

• Reference: Create a fixed location

1
POST /panic-api/v2/predefinedLocations HTTP/1.1
2
Host: staging-panic.aura.services
3
Authorization: Bearer YOUR_ACCESS_TOKEN
4
Content-Type: application/json
5
6
{
7
  "externalReferenceId": "site_9944",
8
  "locationIdentifier": "site_9944",
9
  "locationDescription": "Downtown Branch",
10
  "latitude": "-26.12345",
11
  "longitude": "28.12345",
12
  "formattedAddress": "123 Main Street, Johannesburg",
13
  "calloutLocationTypeId": 3
14
}

Create a Fixed Location callout

When an alarm or operator action requires AURA response, create a callout by passing the Fixed Location’s externalReferenceId.

• Reference: Create a fixed-location callout

1
POST /panic-api/v2/predefinedLocations/externalRef/site_9944/callouts HTTP/1.1
2
Host: staging-panic.aura.services
3
Authorization: Bearer YOUR_ACCESS_TOKEN
4
Content-Type: application/json
5
6
{}

The body is optional. Store the returned callout id for cancellation, events, and polling. If the externalReferenceId is unknown, the API responds with 400 (not 404) and the detail in the message field.

Verify and close the callout

Read the callout back with Get a callout — note the read endpoint returns a richer, nested shape than the creation response.

Staging callouts are never closed automatically. To drive your callout through dispatch, arrival, completion, and closure, open the Responder Simulator in the AURA portal (switch to Staging mode), enter your calloutId, and step through the flow. The simulator does not emit webhook events — poll the callout to observe its state changes.