Create an endpoint | emnify Documentation

import requests
url = "https://cdn.emnify.net/api/v1/endpoint"
payload = {
    "service_profile": { "id": 123 },
    "tariff_profile": { "id": 123 },
    "status": { "id": 0 },
    "name": "test",
    "tags": "test1,test2",
    "imei": "123456789012345",
    "imei_lock": False,
    "sim": {
        "id": 3595575,
        "activate": True
    },
    "ip_address": "127.0.0.1",
    "organisation": { "id": 123 },
    "ip_address_space": { "id": 123 }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())

{
  "id": 1001,
  "ip_address": "10.0.0.1",
  "status": {
    "id": 1,
    "description": "Disabled"
  },
  "name": "Weather Station 01",
  "tags": "sensor,outdoor",
  "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",
    "satellite_capable": false
  },
  "sim": {
    "id": 500,
    "iccid": "8988303000001234567",
    "iccid_with_luhn": "89883030000012345671",
    "sim_profile_type_id": 1,
    "imsi": "901430001234567",
    "msisdn": "882850001234567",
    "status": {
      "id": 2,
      "description": "Suspended"
    }
  },
  "ip_address_space": {
    "id": 1
  }
}

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

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

Creates a single endpoint with the specified configuration. <Note> For bulk operations, use [`POST /api/v2/endpoint/multi`](/developers/api/endpoint/bulk-create-endpoint) instead (supports up to 2,000 endpoints per request). </Note> <Warning> emnify charges for activated SIMs, even if the endpoint status is set to **Disabled**. </Warning>

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.

tagsstringOptional

Comma-separated list of tags (for example, sensor,outdoor).

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.

Private IP address to assign. <Info> If provided, you must also specify `ip_address_space`. </Info>

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.

IP address space for the endpoint. <Info> Required if `ip_address` is provided. </Info>

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.

tagsstring or null

Comma-separated list of tags.

imeistring or null

IMEI with Software Version Number (IMEISV) (16 digits).

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.

simobject or null

SIM card assigned to this endpoint. null if no SIM is assigned.

ip_address_spaceobject

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

imei_with_luhnstring or null

IMEI with Luhn checksum digit, without Software Version Number (15 digits).

Authentication

Request

Response

Errors