> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.aurasos.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.aurasos.com/_mcp/server.

# Create fixed-location callout

POST https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/{externalReferenceId}/callouts
Content-Type: application/json

Creates a callout for a fixed location identified by your external reference. AURA searches the authenticated customer source and its configured installers, then attributes the callout to the customer source that owns the resolved Fixed Location. The legacy `installerIdentifier` request field is accepted for backward compatibility but does not affect lookup or attribution. For Fixed Locations linked to a customer record, the linked customer's source takes precedence when the callout is created.

Reference: https://docs.aurasos.com/api-reference/callouts/create-fixed-location-callout

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Servers

- `https://staging-panic.aura.services` (Staging, default)
- `https://panic.aura.services` (Production)

## Request

### Path parameters

- `externalReferenceId` (string, required) — Partner-defined fixed-location reference.

### Body (application/json)

This endpoint expects a FixedLocationCalloutRequest.

- `calloutExternalReferenceId` (string, optional) — Optional. Your own reference for this alarm, used to correlate the callout with the record in your system. Returned unchanged in the response. AURA does not enforce uniqueness.
- `calloutDetails` (string, optional) — Optional. Free text describing the alarm, shown to the AURA controller handling the response. Use it for anything that helps a responder on arrival, such as the alarm zone or what triggered it.
- `installerIdentifier` (string, optional, deprecated) — Deprecated. Accepted and returned unchanged for backward compatibility, but ignored when resolving the Fixed Location and deciding callout attribution. Omit this field in new integrations.

## Response

### 200

Successful.

- `message` (string, optional)
- `externalReferenceId` (string, optional) — The Fixed Location reference from the request path.
- `calloutExternalReferenceId` (string, optional) — The `calloutExternalReferenceId` you sent, returned unchanged so you can correlate this callout with your own record. Absent when you did not send one.
- `installerRerouted` (boolean, optional) — True when the resolved Fixed Location belongs to an installer and the callout was attributed to that owning customer source. Absent when the Fixed Location belongs to the authenticated source.
- `calloutRerouteInfo` (string, optional) — Human-readable explanation of owner attribution. Present when the resolved Fixed Location belongs to an installer and the callout is attributed to that owner. Absent when no reroute is required.
- `callout` (Callout, optional)
- `installerIdentifier` (string, optional, nullable, deprecated) — The legacy `installerIdentifier` you sent, returned unchanged. It does not affect Fixed Location lookup or callout attribution. Absent when you did not send one.

## Errors

### 400 Bad Request Error

Bad request. An unknown external reference is reported here (not as a 404), with the detail in the `message` field.

- `message` (string, optional)
- `errors` (ErrorResponseErrors, optional) — Error detail. May be a string, an array of strings, or an object (some routes return a serialized error object).

### 401 Unauthorized Error

Unauthorized.

- `message` (string, optional)
- `errors` (ErrorResponseErrors, optional) — Error detail. May be a string, an array of strings, or an object (some routes return a serialized error object).

## Types

### Callout

- `id` (integer, optional)
- `status` (string, optional) — Legacy free-form status with mixed casing, returned exactly as shown. Known values are `created`, `pending`, `acknowledged`, `Responder Dispatched`, `Responder Arrived`, `Responder Completed`, `Responder Cancelled`, and `closed`. Statuses are not forward-only. Redistribution parks the callout on `pending`, then returns it to `created` when no replacement supplier was chosen, or to `Responder Dispatched` when a specific supplier was. A normal sequence can therefore include `created` → `Responder Dispatched` → `pending` → `created` → `Responder Dispatched`. Treat `created`, `pending` and `Responder Dispatched` as active and in progress; do not interpret `pending`, or a return to `created`, as a new callout or a terminal failure. `pending` is also used for a callout created with dispatch deferred.
- `cancelledByCustomer` (boolean, optional)
- `verified` (boolean, optional, nullable)
- `verifiedBy` (string, optional, nullable)
- `verifiedAt` (datetime, optional, nullable)
- `resolvedAt` (datetime, optional, nullable)
- `loggedAt` (datetime, optional)
- `createdAt` (datetime, optional)
- `updatedAt` (datetime, optional)
- `source` (string, optional)
- `dispatchRequired` (boolean, optional)
- `acknowledged` (boolean, optional)
- `owned` (boolean, optional)
- `messageId` (string, optional, nullable)
- `responseTypeId` (integer, optional)
- `calloutClassificationId` (integer, optional)
- `calloutLocationTypeId` (integer, optional, nullable)
- `internalTest` (boolean, optional)
- `parentCalloutId` (integer, optional, nullable)
- `regionId` (integer, optional)
- `inCoverage` (boolean, optional)
- `escalated` (boolean, optional)
- `externalRefId` (string, optional, nullable)
- `customerSourceId` (integer, optional)
- `customerId` (integer, optional, nullable) — Null for callouts not tied to a customer profile (for example fixed-location callouts).
- `url` (string, optional) — Hosted dispatch session URL for this callout.
- `metaData` (CalloutMetaData, optional, nullable) — Internal callout metadata (for example responder media-capture flags or the originating predefined location).
- `integrationUserId` (integer, optional, nullable)
- `ownedByUserId` (integer, optional, nullable)
- `requestedByCustomerId` (integer, optional, nullable)
- `rejectedByCustomerId` (integer, optional, nullable)
- `lastUpdatedBy` (string, optional, nullable)
- `lastUpdatedByClientId` (string, optional, nullable)
- `firstAcknowledgedBy` (string, optional, nullable)
- `firstAcknowledgedAt` (datetime, optional, nullable)
- `ownedBy` (string, optional, nullable)
- `ownedAt` (datetime, optional, nullable)
- `escalatedAt` (datetime, optional, nullable)
- `escalatedBy` (string, optional, nullable)
- `location` (CalloutLocation, optional)
- `calloutResponderInRanges` (list of CalloutCalloutResponderInRangesItems, optional)
- `customer` (Customer, optional) — A customer profile. Read responses include the request profile fields plus the server-managed fields below.
- `customerSource` (CustomerSource, optional) — A limited customer-source summary attached to a callout.
- `calloutincidentdetail` (CalloutCalloutincidentdetail, optional, nullable) — Present on the cancel-callout response.
- `requestedByCustomer` (CalloutRequestedByCustomer, optional, nullable) — Present on the cancel-callout response; fields are null when the cancel was not customer-initiated.
- `routedControlCentre` (boolean, optional, deprecated) — Deprecated. Always false. Will be removed in a future API version.

### ErrorResponseErrors

Error detail. May be a string, an array of strings, or an object (some routes return a serialized error object).

- string
- list of string
- map from string to any

### CalloutMetaData

Internal callout metadata (for example responder media-capture flags or the originating predefined location).

### CalloutLocation

- `latitude` (string, optional)
- `longitude` (string, optional)
- `accuracy` (double, optional)
- `calloutId` (integer, optional)
- `predefinedLocationId` (integer, optional, nullable) — Set when the callout was created against a fixed (predefined) location.
- `formattedAddress` (string, optional, nullable)

### CalloutCalloutResponderInRangesItems

### Customer

A customer profile. Read responses include the request profile fields plus the server-managed fields below.

- `name` (string, optional)
- `surname` (string, optional)
- `mobile` (string, optional) — The customer's unique identifier.
- `email` (string, optional)
- `gender` (string, optional)
- `dateOfBirth` (datetime, optional)
- `businessName` (string, optional)
- `duressCode` (string, optional) — Safe word used to confirm a customer-initiated cancellation.
- `externalReferenceId` (string, optional) — Your own reference for the customer.
- `vehicleMake` (string, optional)
- `vehicleModel` (string, optional)
- `vehicleColour` (string, optional)
- `vehicleLicensePlate` (string, optional)
- `hasMedicalAid` (boolean, optional)
- `medicalConditions` (string, optional)
- `medications` (string, optional)
- `allergies` (string, optional)
- `medicalAidNumber` (string, optional)
- `medicalAidScheme` (string, optional)
- `nextOfKinName` (string, optional)
- `nextOfKinNumber` (string, optional)
- `bloodType` (string, optional)
- `familyDoctorPhoneNumber` (string, optional)
- `medicalOther` (string, optional)
- `id` (integer, optional)
- `customerSourceId` (integer, optional)
- `auth0UserId` (string, optional, nullable)
- `createdAt` (datetime, optional)
- `updatedAt` (datetime, optional)
- `imageId` (integer, optional, nullable)
- `customerTypeId` (integer, optional, nullable)
- `referredByCodeId` (integer, optional, nullable)
- `referredByCustomerId` (integer, optional, nullable)
- `stripeCustomerId` (string, optional, nullable)
- `medicalAidPlan` (string, optional, nullable)
- `hasVehicle` (boolean, optional, nullable)
- `referralCode` (string, optional, nullable) — Present on customer GET responses.
- `hasPanicked` (boolean, optional) — Present on customer GET responses.
- `subscriptions` (list of Subscription, optional) — Present when the customer was created with a subscription or when subscriptions are embedded.

### CustomerSource

A limited customer-source summary attached to a callout.

- `id` (integer, optional)
- `description` (string, optional)

### CalloutCalloutincidentdetail

Present on the cancel-callout response.

- `id` (integer, optional)
- `responderId` (integer, optional, nullable)
- `responderDispatched` (boolean, optional)
- `supplierIdBeforeCancellation` (integer, optional, nullable)
- `supplierId` (integer, optional, nullable)

### CalloutRequestedByCustomer

Present on the cancel-callout response; fields are null when the cancel was not customer-initiated.

- `id` (integer, optional, nullable)
- `mobile` (string, optional, nullable)
- `name` (string, optional, nullable)
- `surname` (string, optional, nullable)
- `email` (string, optional, nullable)

### Subscription

- `id` (integer, optional)
- `customerId` (integer, optional)
- `subscriptionTypeId` (integer, optional)
- `validFrom` (datetime, optional)
- `validTo` (datetime, optional)
- `CancelledDate` (datetime, optional, nullable) — Set when the subscription is cancelled. A subscription has no status field — it is active while within `validFrom`–`validTo` and not cancelled.
- `CancelledReason` (string, optional, nullable)
- `subscriptionToken` (string, optional, nullable)
- `dependantCustomerIds` (list of integer, optional)
- `membersFullName` (string, optional) — Present on customer subscription lookup responses.
- `relationship` (string, optional) — Present on customer subscription lookup responses; one of `MAIN` or `DEPENDANT`.
- `numberOfAddedDependents` (string, optional) — Present on customer subscription lookup responses.
- `subscriptionType` (SubscriptionType, optional)

### SubscriptionType

- `id` (integer, optional)
- `description` (string, optional)
- `value` (string, optional)
- `numberOfAllowedDependents` (SubscriptionTypeNumberOfAllowedDependents, optional, nullable)
- `recurringBilling` (boolean, optional)
- `period` (string, optional, nullable)
- `name` (string, optional, nullable)
- `createdAt` (datetime, optional)
- `updatedAt` (datetime, optional)

### SubscriptionTypeNumberOfAllowedDependents

- integer
- string

## Examples

### Success

**Response**

```json
{
  "message": "Successfully created callout",
  "externalReferenceId": "STORE-001",
  "callout": {
    "id": 12345,
    "status": "created",
    "cancelledByCustomer": false,
    "loggedAt": "2026-06-08T15:33:39.185Z",
    "createdAt": "2026-06-08T15:33:40.620Z",
    "updatedAt": "2026-06-08T15:33:40.620Z",
    "source": "FIXED_LOCATIONS_INTEGRATION",
    "dispatchRequired": true,
    "responseTypeId": 1,
    "calloutClassificationId": 1,
    "internalTest": false,
    "regionId": 1,
    "customerSourceId": 591,
    "customerId": null,
    "url": "https://staging-dispatch.aura.services/dispatch/?sessionToken=example&calloutId=12345",
    "location": {
      "latitude": "-26.2",
      "longitude": "28.2",
      "accuracy": 10,
      "calloutId": 12345,
      "predefinedLocationId": 158659
    }
  }
}
```

**SDK Code**

```python Success
import requests

url = "https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.json())
```

```javascript Success
const url = 'https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Success
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Success
require 'uri'
require 'net/http'

url = URI("https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java Success
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php Success
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
  ],
]);

echo $response->getBody();
```

```csharp Success
using RestSharp;

var client = new RestClient("https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift Success
import Foundation

let headers = ["Authorization": "Bearer <token>"]

let request = NSMutableURLRequest(url: NSURL(string: "https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```

### Callouts_createFixedLocationCallout_example

**Request**

```json
{
  "calloutExternalReferenceId": "ALARM-4471",
  "calloutDetails": "Zone 3 perimeter beam, rear of premises"
}
```

**Response**

```json
{
  "message": "Successfully created callout",
  "externalReferenceId": "STORE-001",
  "callout": {
    "id": 12345,
    "status": "created",
    "cancelledByCustomer": false,
    "loggedAt": "2026-06-08T15:33:39.185Z",
    "createdAt": "2026-06-08T15:33:40.620Z",
    "updatedAt": "2026-06-08T15:33:40.620Z",
    "source": "FIXED_LOCATIONS_INTEGRATION",
    "dispatchRequired": true,
    "responseTypeId": 1,
    "calloutClassificationId": 1,
    "internalTest": false,
    "regionId": 1,
    "customerSourceId": 591,
    "customerId": null,
    "url": "https://staging-dispatch.aura.services/dispatch/?sessionToken=example&calloutId=12345",
    "location": {
      "latitude": "-26.2",
      "longitude": "28.2",
      "accuracy": 10,
      "calloutId": 12345,
      "predefinedLocationId": 158659
    }
  }
}
```

**SDK Code**

```python Callouts_createFixedLocationCallout_example
import requests

url = "https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts"

payload = {
    "calloutExternalReferenceId": "ALARM-4471",
    "calloutDetails": "Zone 3 perimeter beam, rear of premises"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript Callouts_createFixedLocationCallout_example
const url = 'https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"calloutExternalReferenceId":"ALARM-4471","calloutDetails":"Zone 3 perimeter beam, rear of premises"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go Callouts_createFixedLocationCallout_example
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts"

	payload := strings.NewReader("{\n  \"calloutExternalReferenceId\": \"ALARM-4471\",\n  \"calloutDetails\": \"Zone 3 perimeter beam, rear of premises\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby Callouts_createFixedLocationCallout_example
require 'uri'
require 'net/http'

url = URI("https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"calloutExternalReferenceId\": \"ALARM-4471\",\n  \"calloutDetails\": \"Zone 3 perimeter beam, rear of premises\"\n}"

response = http.request(request)
puts response.read_body
```

```java Callouts_createFixedLocationCallout_example
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"calloutExternalReferenceId\": \"ALARM-4471\",\n  \"calloutDetails\": \"Zone 3 perimeter beam, rear of premises\"\n}")
  .asString();
```

```php Callouts_createFixedLocationCallout_example
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts', [
  'body' => '{
  "calloutExternalReferenceId": "ALARM-4471",
  "calloutDetails": "Zone 3 perimeter beam, rear of premises"
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp Callouts_createFixedLocationCallout_example
using RestSharp;

var client = new RestClient("https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"calloutExternalReferenceId\": \"ALARM-4471\",\n  \"calloutDetails\": \"Zone 3 perimeter beam, rear of premises\"\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift Callouts_createFixedLocationCallout_example
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "calloutExternalReferenceId": "ALARM-4471",
  "calloutDetails": "Zone 3 perimeter beam, rear of premises"
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://staging-panic.aura.services/panic-api/v2/predefinedLocations/externalRef/STORE-001/callouts")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```