> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nox.energy/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.



## OpenAPI

````yaml /api-docs/manufacturer-integration/openapi-manufacturer-auth.json post /manufacturers/nox
openapi: 3.0.3
info:
  title: NOX Authenticator API
  description: >-
    API for device authentication and linking in the NOX ecosystem.
    **Deprecated:** use the v2 Authenticator API at `https://auth.nox.energy/v2`
    and the **Manufacturer Integration** section in this documentation.
  version: 1.0.0
  contact:
    name: NOX Integration Team
    email: integration@nox.com
servers:
  - url: https://auth.nox.energy
    description: Server
security: []
tags:
  - name: Supplier Integration
    description: Device authentication and linking
  - name: Sessions
    description: Link session management
  - name: Manufacturer Integration
    description: Manufacturer connection management
paths:
  /manufacturers/nox:
    post:
      tags:
        - Manufacturer Integration
      summary: Connect User to NOX
      description: >-
        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.
      operationId: connectNoxManufacturer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NoxManufacturerConnectionRequest'
            example:
              manufacturer_user_id: mfr_user_123
              device_ids:
                - device_001
                - device_002
      responses:
        '201':
          description: User successfully connected to NOX
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NoxConnectionResponse'
        '400':
          description: Bad request - Invalid or missing parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: >-
            Unauthorized - Invalid API key or manufacturer not enabled for
            connection
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: true
      security:
        - ApiKeyAuth: []
components:
  schemas:
    NoxManufacturerConnectionRequest:
      type: object
      required:
        - manufacturer_user_id
      properties:
        manufacturer_user_id:
          type: string
          description: The manufacturer's unique identifier for the user
          example: mfr_user_123
        device_ids:
          type: array
          items:
            type: string
          description: Optional list of device IDs to associate with this connection
          example:
            - device_001
            - device_002
    NoxConnectionResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        timestamp:
          type: integer
          description: Unix timestamp
          example: 1703123456
        data:
          type: object
          properties:
            manufacturer_user_id:
              type: string
              description: The manufacturer's user ID that was provided
              example: mfr_user_123
            nox_user_id:
              type: string
              description: The NOX user ID assigned to this user
              example: 550e8400-e29b-41d4-a716-446655440000
            device_ids:
              type: array
              items:
                type: string
              description: List of device IDs associated with this connection
              example:
                - device_001
                - device_002
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          example: false
        timestamp:
          type: integer
          description: Unix timestamp
          example: 1703123456
        error:
          type: string
          description: Human-readable error message
          example: Missing API key
        error_code:
          type: string
          description: Machine-readable error code
          example: missing_api_key
        message:
          type: string
          description: Error message
          example: Missing API key
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key for authentication. You can also use 'Authorization: ApiKey
        YOUR_KEY' header.

````