Create fixed location | Aura Panic API

curl -X POST https://staging-panic.aura.services/panic-api/v2/predefinedLocations \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "externalReferenceId": "DOCS-EXTERNAL-1",
  "locationIdentifier": "DOCS-LOC-1",
  "latitude": "-26.2",
  "longitude": "28.2"
}'

{
  "id": 22,
  "customerId": 3,
  "customerSourceId": 35,
  "externalReferenceId": "SHOP",
  "locationIdentifier": "must also be unique string 123",
  "locationDescription": "some description",
  "locationAdditionalInformation": "upstairs flat with big dog",
  "formattedAddress": "23 baker street",
  "latitude": "-27.45678",
  "longitude": "26.678819",
  "w3w": "panther.logbook.blue",
  "calloutLocationTypeId": 3,
  "calloutLocationTypeValue": "string",
  "calloutLocationTypeDescription": "string",
  "duressCode": "string",
  "medicalCoverage": true,
  "securityCoverage": true,
  "inCoverageLastCheckedAt": "2024-01-15T09:30:00Z",
  "createdAt": "2024-01-15T09:30:00Z",
  "updatedAt": "2024-01-15T09:30:00Z",
  "calloutLocationType.id": 1,
  "calloutLocationType.value": "string",
  "calloutLocationType.description": "string",
  "calloutLocationType.addressType": "string",
  "calloutLocationType.createdAt": "2024-01-15T09:30:00Z",
  "calloutLocationType.updatedAt": "2024-01-15T09:30:00Z"
}

Creates a Fixed Location that can later be used to create Fixed Location callouts. Payload fields retain the API’s predefined-location naming.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

externalReferenceIdstringRequired

locationIdentifierstringRequired

latitudestringRequired

longitudestringRequired

calloutLocationTypeIdintegerOptional

customerIdintegerOptional

locationDescriptionstringOptional

locationAdditionalInformationstringOptional

formattedAddressstringOptional

w3wstringOptional

duressCodestringOptional

Legacy field. New integrations should omit it.

Response

Successful.

idinteger

customerIdinteger or null

customerSourceIdinteger

externalReferenceIdstring

locationIdentifierstring

A unique string you assign to identify the site.

locationDescriptionstring or null

locationAdditionalInformationstring or null

formattedAddressstring or null

latitudestring

longitudestring

w3wstring or null

what3words address for the site.

calloutLocationTypeIdinteger or null

calloutLocationTypeValuestring or null

calloutLocationTypeDescriptionstring or null

duressCodestring or null

Legacy field. New integrations should not rely on it.

medicalCoverageboolean or null

securityCoverageboolean or null

inCoverageLastCheckedAtdatetime or null

createdAtdatetime

updatedAtdatetime

calloutLocationType.idinteger or null

Literal top-level key whose name contains a dot (a serialization artifact), not a nested calloutLocationType object. Treat these calloutLocationType.* keys as opaque; they are null unless a callout location type is assigned.

calloutLocationType.valuestring or null

calloutLocationType.descriptionstring or null

calloutLocationType.addressTypestring or null

calloutLocationType.createdAtdatetime or null

calloutLocationType.updatedAtdatetime or null

Errors

400

Bad Request Error

401

Unauthorized Error