Skip to main content
POST
/
manufacturer
/
link-sessions
Create manufacturer link session
curl --request POST \
  --url https://auth.nox.energy/v2/manufacturer/link-sessions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "user_id": "<string>",
  "redirect_url": "<string>",
  "language": "nl"
}
'
{
  "link_url": "https://auth.nox.energy/ui?token=abc123&language=nl",
  "link_token": "<string>",
  "language": "nl",
  "redirect_url": "<string>",
  "manufacturer": "<string>",
  "manufacturer_user_id": "<string>",
  "created_at": 123,
  "expires_at": 123,
  "brand": "<string>",
  "completed_at": 123
}

Authorizations

​
x-api-key
string
header
required

API key assigned to the manufacturer.

Body

application/json
​
user_id
string
required

The manufacturer's internal user ID for the end-user.

​
redirect_url
string<uri>
required

Callback URL where the user is redirected after completing the flow. Must be in the manufacturer's allowed redirect URLs.

​
language
enum<string>
default:nl

Language for the Authenticator UI.

Available options:
nl,
en,
fr,
es

Response

Link session created successfully.

​
link_url
string<uri>
required

Full URL to redirect the end-user to the NOX Authenticator UI.

Example:

"https://auth.nox.energy/ui?token=abc123&language=nl"

​
link_token
string
required

Unique token identifying this link session.

​
language
enum<string>
default:nl
required

Language for the Authenticator UI.

Available options:
nl,
en,
fr,
es
​
redirect_url
string<uri>
required

The redirect URL that was provided.

​
manufacturer
string
required

Name of the manufacturer (resolved from API key).

​
manufacturer_user_id
string
required

The manufacturer's user ID.

​
created_at
integer
required

Unix timestamp when the session was created.

​
expires_at
integer
required

Unix timestamp when the session expires (10 minutes after creation).

​
brand
string

The manufacturer's brand name (title-cased).

​
completed_at
integer | null

Unix timestamp when the session was completed. Always null on creation.