Create an endpoint

POST

https://iot.telia.lt/api/v1/endpoint

POST

/api/v1/endpoint

curl -X POST https://iot.telia.lt/api/v1/endpoint \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "service_profile": {
    "id": 123
  },
  "tariff_profile": {
    "id": 123
  },
  "status": {
    "id": 0
  },
  "name": "test",
  "tag_assignments": [
    1,
    2
  ],
  "imei": "123456789012345",
  "imei_lock": false,
  "sim": {
    "id": 3595575,
    "activate": true
  },
  "ip_address": "127.0.0.1",
  "organisation": {
    "id": 123
  },
  "ip_address_space": {
    "id": 123
  }
}'

{
  "id": 1001,
  "ip_address": "10.0.0.1",
  "status": {
    "id": 1,
    "description": "Disabled"
  },
  "name": "Weather Station 01",
  "created": "2024-01-15T14:44:27.622+0000",
  "last_updated": "2024-01-15T14:44:27.622+0000",
  "imei_lock": false,
  "service_profile": {
    "id": 200,
    "name": "Standard IoT"
  },
  "tariff_profile": {
    "id": 100,
    "name": "Global IoT Plan"
  },
  "ip_address_space": {
    "id": 1
  },
  "tags": "sensor,outdoor",
  "tag_assignments": [
    {
      "id": 1,
      "name": "sensor",
      "tag_color": {
        "id": 3
      }
    },
    {
      "id": 2,
      "name": "outdoor",
      "tag_color": {
        "id": 5
      }
    }
  ],
  "imei": "3561234567890123",
  "sim": {
    "id": 500,
    "iccid": "8988303000001234567",
    "iccid_with_luhn": "89883030000012345671",
    "sim_profile_type_id": 1,
    "imsi": "901430001234567",
    "msisdn": "882850001234567",
    "status": {
      "id": 2,
      "description": "Suspended"
    }
  },
  "imei_with_luhn": "356123456789015"
}

Creates a single endpoint with the specified configuration.

For bulk operations, use POST /api/v2/endpoint/multi instead (supports up to 2,000 endpoints per request).

Telia charges for activated SIMs, even if the endpoint status is set to Disabled.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Request

This endpoint expects an object.

service_profileobjectRequired

Service profile that determines network access settings. Must belong to your organization.

tariff_profileobjectRequired

Tariff profile that determines pricing and data limits. Must belong to your organization.

statusobjectRequired

Initial endpoint status.

namestringOptional

Display name for the endpoint.

tag_assignmentslist of integersOptional

IDs of existing tags to assign to the endpoint. Unlike tags, tags are not created automatically, so every ID must already exist.

Mutually exclusive with tags. Provide at most one of the two.

imeistringOptional

International Mobile Equipment Identity with Software Version Number (IMEISV) (16 digits).

imei_lockbooleanOptionalDefaults to false

If true, this endpoint only allows connections from the device with the specified IMEI.

simobjectOptional

SIM card to assign to this endpoint. If omitted, no SIM is assigned.

ip_addressstringOptional

Private IP address to assign.

If provided, you must also specify ip_address_space.

organisationobjectOptional

Organization to create the endpoint in. Required only for reseller accounts creating endpoints in sub-organizations.

ip_address_spaceobjectOptional

IP address space for the endpoint.

Required if ip_address is provided.

tagsstringOptionalDeprecated

Comma-separated list of tags (for example, sensor,outdoor). Tags that do not exist yet are created.

Deprecated. Use tag_assignments instead.

Response

Endpoint created successfully.

idinteger

Unique identifier for the endpoint.

ip_addressstring

Private IP address assigned to this endpoint.

statusobject

Endpoint connectivity status.

namestring

Display name for the endpoint.

createdstringformat: "date-time"

Date and time when the endpoint was created (ISO 8601 format).

last_updatedstringformat: "date-time"

Date and time when the endpoint was last modified (ISO 8601 format).

imei_lockboolean

If true, this endpoint only allows connections from the device with the specified IMEI.

service_profileobject

Service profile assigned to this endpoint.

tariff_profileobject

Tariff profile assigned to this endpoint.

ip_address_spaceobject

IP address space containing this endpoint's private IP address.

tagsstringDeprecated

Comma-separated list of tags. Empty when the endpoint has no tags assigned.

Deprecated. Use tag_assignments instead.

tag_assignmentslist of objectsOptional

Structured tag data with color information.

imeistringOptional

IMEI with Software Version Number (IMEISV) (16 digits). Omitted when the device hasn’t reported an IMEI.

simobjectOptional

SIM card assigned to this endpoint. Omitted when the endpoint has no SIM.

imei_with_luhnstringOptional

IMEI with Luhn checksum digit, without Software Version Number (15 digits). Omitted when the device hasn’t reported an IMEI.

Errors

400

Bad Request Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error