Link a device to a customer

curl -X POST https://staging-panic.aura.services/panic-api/v2/devices \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "customerId": 12345,
  "deviceSerial": "111111111111111AAABBBB",
  "deviceSupplier": "Sigfox",
  "deviceAlias": "Panic Button",
  "deviceType": 1,
  "firmwareVersion": "1.0"
}'

{
  "id": 429,
  "customerId": 12345,
  "customerSourceId": 3,
  "deviceId": "103528AB",
  "deviceSerial": "000000000103528ABCDEF0000",
  "alias": "Panic Button",
  "deviceTypeId": 47,
  "firmwareVersion": "1.0",
  "defaultLocation": null,
  "healthCheckLastReceivedDate": null,
  "batteryLevel": null,
  "batteryLevelLastReceivedDate": null,
  "createdAt": "2026-06-09T10:35:41.719Z",
  "updatedAt": "2026-06-09T10:35:41.719Z"
}

Links a supported IoT device to a customer so it can create callouts on their behalf. Once linked, ongoing device messages are sent to the device-event endpoint, where a device template maps them to AURA actions.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

customerIdintegerRequired

deviceSerialstringRequired

deviceSupplierstringRequired

deviceAliasstringOptional

deviceTypeintegerOptional

Optional device type identifier. If omitted, AURA attempts to resolve the type from deviceSupplier. The supplied serial must still match the registered device template for that type or supplier.

firmwareVersionstring or integerOptional

Response

Successful.

idinteger

customerIdinteger

customerSourceIdinteger

deviceIdstring

The device identifier AURA derives from the serial (used to match incoming device events).

deviceSerialstring

aliasstring

deviceTypeIdinteger

firmwareVersionstring

defaultLocationobject or null

healthCheckLastReceivedDatedatetime or null

batteryLevelinteger or null

batteryLevelLastReceivedDatedatetime or null

createdAtdatetime

updatedAtdatetime

Errors

400

Bad Request Error

401

Unauthorized Error