Create fixed location
Creates a Fixed Location that can later be used to create Fixed Location callouts. Payload fields retain the API’s predefined-location naming.
Supply both latitude and longitude unless AURA has enabled address geocoding for your integration. When enabled, omit both keys and send a nonblank formattedAddress. Geocoding is a fallback only when coordinates are unavailable and does not guarantee the correct site location; verify the returned coordinates. See the Fixed Locations guide on docs.aurasos.com for details.
Send installerIdentifier to create the site against one of your installers; omit it to create it against your own customer source. Ownership is fixed at creation and cannot be changed afterwards, so a site is moved between installers by deleting it and creating it under the new owner.
If AURA has configured your account to assign unmatched installers to you, an installerIdentifier that matches none of your installers creates the site against your own customer source instead of being rejected. This suits monitoring platforms that send an installer or dealer value on every site while you hold the contract for the whole estate. The response then reports installerIdentifier as null with your own customerSourceId. Matching is exact, so a value that differs from a configured installer only in case or spacing also lands on your own customer source.
Callout-scoped tokens cannot use this endpoint. Use a server token.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
Optional stable fixed-location reference maintained by your integration. Supply it if you intend to reconcile or raise callouts by your own reference; omit it to identify the location by its AURA id alone.
The installer that should own the new site, as an installerIdentifier returned by GET /panic-api/v2/installers. A value that matches none of them is rejected with 400, unless AURA has configured your account to assign unmatched installers to you, in which case the site is created against your own customer source. Omit it, or send null, to create the site against your own customer source. Ownership is fixed at creation: it cannot be changed later, so a site is moved between installers by deleting it and creating it under the new owner. An installer with no installerIdentifier of its own cannot be named here.
Stored exactly as sent; only coordinates are derived during geocoding. Required and must be nonblank when both coordinate keys are omitted and address geocoding is enabled for your integration.
Whether a responder must enter the premises to complete the site check. Defaults to false when omitted.
Supply with longitude; omit both only when address geocoding is enabled and a nonblank formattedAddress is supplied.
Supply with latitude; omit both only when address geocoding is enabled and a nonblank formattedAddress is supplied.
Response
The named installer that owns this site. null means either that the site belongs to your own customer source or that it belongs to an installer whose identifier has been cleared. Use customerSourceId when you need to distinguish those cases. Always null if you have no installers.
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.
Fixed-location contacts. Returned by singular reads and by create and update operations. Deliberately omitted from the broad list response, because contact email addresses and mobile numbers are personal data; resolve an id from the list and read that fixed location singly when you need them.
