<Info icon="fa-light fa-lock" className="permission-callout">
<div className="permission-callout__header"><span className="permission-callout__title"><span className="permission-callout__label">Required permissions</span> <span className="fern-docs-badge small blue subtle rounded-full permission-callout__beta">Beta</span></span> <span className="permission-callout__learn-more">[Learn more](/developers/api-guidelines/permissions#how-permissions-work)</span></div>
`Endpoint` + `Create`
<div className="permission-callout__roles"><span className="permission-callout__roles-label">Roles:</span> <Badge intent="info">Administrator</Badge> <Badge intent="info">User</Badge></div>
</Info>
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>
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.
<Info>
Mutually exclusive with `tags`. Provide at most one of the two.
</Info>
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.
<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.
<Info>
Required if `ip_address` is provided.
</Info>
tagsstringOptionalDeprecated
Comma-separated list of tags (for example, `sensor,outdoor`).
Tags that do not exist yet are created.
<Warning>
Deprecated. Use `tag_assignments` instead.
</Warning>
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.
