Connect User to NOX

Connects a manufacturer user to NOX without linking to an energy supplier account. Use this endpoint when the user does not need to be connected to an energy supplier via OAuth. Creates or updates the subscriber record with the provided device IDs.

POST /manufacturers/nox

Connect User to NOX

cURL

curl --request POST \
  --url https://auth.nox.energy/manufacturers/nox \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "manufacturer_user_id": "mfr_user_123",
  "device_ids": [
    "device_001",
    "device_002"
  ]
}
'

201

{
  "success": true,
  "timestamp": 1703123456,
  "data": {
    "manufacturer_user_id": "mfr_user_123",
    "nox_user_id": "550e8400-e29b-41d4-a716-446655440000",
    "device_ids": [
      "device_001",
      "device_002"
    ]
  }
}

Authorizations

x-api-key · string · header · required

API key for authentication. You can also use 'Authorization: ApiKey YOUR_KEY' header.

Body

application/json

manufacturer_user_id · string · required

The manufacturer's unique identifier for the user

Example:

"mfr_user_123"

device_ids · string[]

Optional list of device IDs to associate with this connection

Example:

["device_001", "device_002"]

Response

201

application/json

User successfully connected to NOX

success · boolean

Example:

true

timestamp · integer

Unix timestamp

Example:

1703123456

data · object

Show child attributes