Getting Started
To use the emnify REST API, you must authenticate with an Authentication Token. emnify uses JSON Web Tokens (JWTs) as the authentication token.
You can retrieve this authentication token using an application token generated in your emnify account.
The following pages cover the authentication basics, querying resources, and how to create and use application tokens for automating or scheduling recurring tasks.
Authentication
When the /api/v1/authenticate
API is sent an application token, it returns an auth token used to authenticate all subsequent calls to the API via the Authorization
header.
JWTs
JSON Web Tokens (JWTs) are a secure mechanism to authenticate all API calls via the Authorization
header. This page describes how to obtain a JWT auth_token
and how they are used in requests.
Warning: Historically, you could retrieve the authentication token in two ways: with your user credentials (username and password) or an application token. To improve security across our services, authentication with user credentials has now been deprecated and will be removed on March 28, 2024. Please authenticate with application tokens instead.
See the deprecation notice for more information about why emnify is making this change.