Favicon

You are here: Home > API Reference > UEM > Mdm Users > Create new MDM user account

POST /organizations/:organizationId/mdm/users

Required Permission: mdm.global.mdmUser.create

Create new device management user account with contact information, tags, and language preferences for enrollment and device assignments.

POST
https://api.applivery.io/v1/organizations/{organizationId}/mdm/users 
curl -X POST "https://api.applivery.io/v1/organizations/{organizationId}/mdm/users" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "email": "[email protected]",
  "name": "string",
  "managedAppleId": "[email protected]",
  "tags": [
    "string"
  ],
  "language": "es",
  "metadata": {}
}'
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/users", {
  method: "POST",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "email": "[email protected]",
    "name": "string",
    "managedAppleId": "[email protected]",
    "tags": [
      "string"
    ],
    "language": "es",
    "metadata": {}
  }),
});

const data = await response.json();
import requests

response = requests.post(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/users",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
    json={
      "email": "[email protected]",
      "name": "string",
      "managedAppleId": "[email protected]",
      "tags": [
        "string"
      ],
      "language": "es",
      "metadata": {}
    },
)

data = response.json()

Request

Send your API key in the request header authorization
Example: Authorization: Bearer <token>

organizationId string
required
Organization identifier or URL-friendly slug for scoping user operations within specific workspace and access control boundaries.
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Body Params application/json
email string required
Primary contact address for device user utilized for enrollment notifications, account identification, and administrative communications.
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
name string optional
Display name for device management user shown in administrative interfaces and reports for identification and personalization purposes.
≤ 256 characters
managedAppleId string optional
Managed Apple ID email address linked to this user for Apple Business Manager integration and app license distribution.
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
tags array optional
Organizational labels assigned to user for categorization, filtering, and grouping in listings and automation rule targeting.
language string optional
Preferred language code for user controlling interface localization, email communications, and notification content throughout platform.
es en fr de it zh pt ru
metadata object optional
Custom key-value pairs storing additional user information for integration purposes, reporting needs, or organizational specific requirements.
{
    "email": "[email protected]",
    "name": "string",
    "managedAppleId": "[email protected]",
    "tags": [
        "string"
    ],
    "language": "es",
    "metadata": {}
}

Responses

200 Response application/json
status boolean required
data object required
id string required
Unique identifier for device management user enabling targeted operations and tracking across all platform endpoints and administrative interfaces.
Match pattern: ^[a-fA-F0-9]{24}$
email string required
Primary contact address for device user utilized for enrollment notifications, account identification, and administrative communications.
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
name string required
Display name for device management user shown in administrative interfaces and reports for identification and personalization purposes.
≤ 256 characters
tags array required
Organizational labels assigned to user for categorization, filtering, and grouping in listings and automation rule targeting.
android object required
Android platform statistics aggregating device counts and enrollment token status for Android Enterprise management visibility and analytics.
devices object required
Device count distribution by Android Enterprise management mode showing organizational control model breakdown.
enrollmentTokens object required
Enrollment token count distribution categorized by lifecycle status tracking Android device provisioning and registration completion.
aosp object required
AOSP platform statistics aggregating custom DPC non-GMS Android device counts and enrollment token lifecycle status for backend-managed Android visibility.
devices object required
Device count distribution by AOSP management mode showing non-GMS Android ownership model breakdown.
enrollmentTokens object required
Enrollment token count distribution categorized by AOSP token lifecycle state for non-GMS Android provisioning tracking.
apple object required
Apple platform statistics showing enrolled device count and active enrollment profile assignments for iOS, iPadOS, and macOS management.
devices integer required
Total count of Apple devices enrolled under this user across iOS, iPadOS, and macOS platforms for inventory tracking.
≥ 0 · ≤ 9007199254740991
enrollmentTokens integer required
≥ 0 · ≤ 9007199254740991
windows object required
Windows platform statistics displaying enrolled device count and available enrollment tokens for Windows desktop management operations.
devices integer required
Total count of Windows devices enrolled and managed under this user for desktop and laptop inventory tracking purposes.
≥ 0 · ≤ 9007199254740991
enrollmentTokens integer required
Count of active Windows enrollment tokens assigned to this user enabling device registration and policy application processes.
≥ 0 · ≤ 9007199254740991
language string required
Preferred language code for user controlling interface localization, email communications, and notification content throughout platform.
es en fr de it zh pt ru
managedAppleId string optional
Managed Apple ID email address linked to this user for Apple Business Manager integration and app license distribution.
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
metadata object required
Custom key-value pairs storing additional user information for integration purposes, reporting needs, or organizational specific requirements.
inferredSegmentIds array [number] required
List of segment where the user in included
createdAt string required
ISO 8601 timestamp indicating when user account was initially created providing historical context and analytics for user lifecycle tracking.
updatedAt string required
ISO 8601 timestamp indicating when user record was most recently modified useful for tracking changes, synchronization, and audit trail.
{
    "status": true,
    "data": {
        "id": "string",
        "email": "[email protected]",
        "name": "string",
        "tags": [
            "string"
        ],
        "android": {
            "devices": {
                "MANAGEMENT_MODE_UNSPECIFIED": 0,
                "DEVICE_OWNER": 0,
                "PROFILE_OWNER": 0
            },
            "enrollmentTokens": {
                "DONE": 0,
                "PENDING": 0,
                "EXPIRED": 0,
                "DELETED": 0
            }
        },
        "aosp": {
            "devices": {
                "MANAGEMENT_MODE_UNSPECIFIED": 0,
                "DEVICE_OWNER": 0
            },
            "enrollmentTokens": {
                "DONE": 0,
                "PENDING": 0,
                "PROCESSING": 0,
                "EXPIRED": 0,
                "DELETED": 0
            }
        },
        "apple": {
            "devices": 0,
            "enrollmentTokens": 0
        },
        "windows": {
            "devices": 0,
            "enrollmentTokens": 0
        },
        "language": "es",
        "managedAppleId": "[email protected]",
        "metadata": {},
        "inferredSegmentIds": [
            0
        ],
        "createdAt": "string",
        "updatedAt": "string"
    }
}
400 Response application/json
status boolean optional
false
error object optional
code number optional
5050
message string optional
Feature not allowed for you billing plan
{
    "status": false,
    "error": {
        "code": 5048,
        "message": "Mdm user already exists"
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4001
message string optional
Unauthorized
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}