Create fixed-location callout

{
  "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
    }
  }
}

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.

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.

Authentication

AuthorizationBearer

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

Path parameters

externalReferenceIdstringRequired

Partner-defined fixed-location reference.

Request

This endpoint expects an object.

calloutExternalReferenceIdstringOptional

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.

calloutDetailsstringOptional

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.

installerIdentifierstringOptionalDeprecated

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

Successful.

messagestringOptional

externalReferenceIdstringOptional

The Fixed Location reference from the request path.

calloutExternalReferenceIdstringOptional

The calloutExternalReferenceId you sent, returned unchanged so you can correlate this callout with your own record. Absent when you did not send one.

installerReroutedbooleanOptional

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.

calloutRerouteInfostringOptional

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.

calloutobjectOptional

installerIdentifierstring or nullOptionalDeprecated

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

401

Unauthorized Error