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.

idintegerOptional

customerIdintegerOptional

customerSourceIdintegerOptional

deviceIdstringOptional

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

deviceSerialstringOptional

aliasstringOptional

deviceTypeIdintegerOptional

firmwareVersionstringOptional

defaultLocationobject or nullOptional

healthCheckLastReceivedDatedatetime or nullOptional

batteryLevelinteger or nullOptional

batteryLevelLastReceivedDatedatetime or nullOptional

createdAtdatetimeOptional

updatedAtdatetimeOptional

Errors

400

Bad Request Error

401

Unauthorized Error