POST
/
v1
/
onboarding
/
entities
Create an Entity Onboarding Request
curl --request POST \
  --url https://prd.der-connect.eliagroup.eu/api/v1/onboarding/entities \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "collectiveId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "code": "<string>",
  "ean": "<string>",
  "email": "<string>",
  "manufacturer": "<string>",
  "model": "<string>",
  "owner": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "properties": "<any>",
  "reference": "<string>",
  "returnUrl": "<string>",
  "track": "<string>",
  "type": "Battery",
  "uuid": "<string>",
  "vin": "<string>"
}'
{
  "action": {
    "documentationLink": "<string>",
    "redirectLink": "<string>",
    "type": "Consent"
  },
  "created": "2023-11-07T05:31:56Z",
  "data": {
    "collective": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "owner": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "properties": "<any>",
      "type": "Household"
    },
    "entity": {
      "collectiveId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "information": {
        "code": "<string>",
        "ean": "<string>",
        "email": "<string>",
        "manufacturer": "<string>",
        "model": "<string>",
        "reference": "<string>",
        "track": "<string>",
        "type": "Battery",
        "uuid": "<string>",
        "vin": "<string>"
      },
      "owner": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "properties": "<any>",
      "reference": {
        "manufacturer": "<string>",
        "type": "<string>",
        "reference": "<string>"
      },
      "systemProperties": "<any>",
      "type": "Battery"
    }
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "principalId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "requestType": "Collective",
  "returnUrl": "<string>",
  "status": "Canceled",
  "errors": [
    {
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

​
Required Parameters

​
type
enum<string>
required
Specify the type of device or vehicle that you want to connect with.
Available options are Battery, Boiler, ChargePole, EV, HeatPump, PV, RetrofitMeter, and SmartMeter.
​
manufacturer
string
required
Specify the manufacturer (for example: “Audi” or “Huawei”) of the device or vehicle you want to connect with. List all available Entity manufacturers to learn about the available options.

​
Device Identifiers

Most manufacturers assign a unique identifier to their devices. Depending on the type or brand of the device you’re onboarding, you may need to provide one or more of these identifiers to complete the request.
Onboarding something else? Read our guide on manual onboarding.

​
Detailed Endpoint Reference

Authorizations

​
Authorization
string
header
required

Access Token Authentication

Body

The Entity Onboarding Request.

The entity can be placed in a Collective.

Represents a request to onboard an Entity

Response

201
application/json

Created

Represents an onboarding request