Authentication

Overview

API keys are used to authenticate all requests to the Nomid MDM API. Include your API key in the X-API-Key header with every request.

X-API-Key: nm_acme_a1b2c3d4e5f6...

Getting Your API Key

API keys are created and managed through the Nomid Portal. Follow these steps to create your first API key.

Prerequisites

• A Nomid MDM account with administrator access
• Access to the Company Settings in the Nomid Portal

1. 1

   Log in to the Nomid Portal

   Open your browser and navigate to the Nomid Portal. Sign in with your administrator credentials.

2. 2

   Navigate to Integrations

   Once logged in, go to the Company Settings section and select the Integrations tab.

3. 3

   Click Create API Key

   Click the "Create API Key" button located in the top-right corner of the Integrations page.

4. 4

   Enter a Name

   In the modal that appears, enter a descriptive name for your API key. This helps you identify the key later (e.g., "Power BI Integration" or "CRM Sync").

5. 5

   Copy Your Key

   After clicking Create, your API key will be displayed. Click the copy button to copy it to your clipboard. The key will only be shown once!

API Key Format

API keys follow this format:

nm_{company}_{random_32_chars}

• All keys start with 'nm_'
• Company-specific prefix for identification
• 32 random characters for security

Using Your API Key

Include the API key in the X-API-Key header with every request:

curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
  -H "X-API-Key: nm_acme_a1b2c3d4e5f6..."

Security Best Practices

• Never expose API keys in client-side code or public repositories
• Rotate keys regularly and revoke unused keys
• Store keys in environment variables, not in code
• Use the minimum permissions necessary for your integration

Authentication Errors

The API returns specific error codes for authentication issues: