endpoint

Bulk create endpoints

<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 <span className="permission-callout__also">+1 endpoint</span>

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

Create up to 2,000 endpoints in one request.

Unlike POST /api/v1/endpoint, this bulk endpoint handles multiple endpoints safely in a single request without sequential execution constraints between individual endpoints.

<Note> Execute bulk operations sequentially - wait for each bulk request to complete before starting the next. </Note>

If a sim object is provided, the specified SIM is assigned to the endpoint and is activated by default. To assign the SIM without activating it, explicitly set the activate property to false; omitting it activates the SIM.

When the SIM is activated:

  • The SIM enters Factory Test Mode (FTM) if FTM is enabled for the organization.
  • Otherwise, it goes directly to Activated.

To override this behavior and explicitly set the SIM's status (for example, skip FTM even if it's enabled for your organization), include a status object within the sim object.

<Warning> emnify charges for activated SIMs, even if the endpoint status is set to **Disabled**. </Warning>
post/api/v2/endpoint/multi

Request

  • Base URL: https://cdn.emnify.net
  • URL: https://cdn.emnify.net/api/v2/endpoint/multi
  • Auth: HTTP bearer

Request body

Response

idnumber double required
ip_addressstring required
namestring required
tagsstring required

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

<Warning> Deprecated. Use `tag_assignments` instead. </Warning>
imeistring
createdstring date-time required
last_updatedstring date-time required
imei_lockboolean required
simApiV2EndpointMultiPostResponsesContentApplicationJsonSchemaItemsSim
ip_address_spaceApiV2EndpointMultiPostResponsesContentApplicationJsonSchemaItemsIpAddressSpace required
imei_with_luhnstring

Changes

No recorded changes to this operation across all 1 revision of this API.