Favicon

You are here: Home > API Reference > Android > Enrollmenttokens > Create bulk enrollment tokens

Create bulk enrollment tokens

Required Permission: mdm.android.enrollmentToken.create

Creates multiple enrollment tokens simultaneously for streamlined distribution to end users or groups.

POST
https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/enrollment-tokens/bulk 
curl -X POST "https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/enrollment-tokens/bulk" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "policyId": "string",
  "emmPolicyAssignments": [
    {}
  ],
  "displayName": "string",
  "tags": [
    "string"
  ],
  "managementMode": "DEVICE_OWNER",
  "sendEmail": true,
  "duration": 0,
  "language": "es",
  "emailText": "string",
  "segmentId": 0,
  "userEmails": [
    "[email protected]"
  ]
}'
const response = await fetch("https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/enrollment-tokens/bulk", {
  method: "POST",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "policyId": "string",
    "emmPolicyAssignments": [
      {}
    ],
    "displayName": "string",
    "tags": [
      "string"
    ],
    "managementMode": "DEVICE_OWNER",
    "sendEmail": true,
    "duration": 0,
    "language": "es",
    "emailText": "string",
    "segmentId": 0,
    "userEmails": [
      "[email protected]"
    ]
  }),
});

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

response = requests.post(
    "https://api.applivery.io/v1/organizations/{organizationId}/mdm/android/enterprise/enrollment-tokens/bulk",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
    json={
      "policyId": "string",
      "emmPolicyAssignments": [
        {}
      ],
      "displayName": "string",
      "tags": [
        "string"
      ],
      "managementMode": "DEVICE_OWNER",
      "sendEmail": true,
      "duration": 0,
      "language": "es",
      "emailText": "string",
      "segmentId": 0,
      "userEmails": [
        "[email protected]"
      ]
    },
)

data = response.json()

Request

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

organizationId string
required
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Body Params application/json
policyId string optional
Primary Android Enterprise policy identifier applied to devices enrolling with this token as default configuration baseline.
Match pattern: ^[a-fA-F0-9]{24}$
emmPolicyAssignments array [object] optional
Ordered list of Android Enterprise policy assignments applied to devices enrolling with this token prioritized by sequence.
emmPolicyId string required
Match pattern: ^[a-fA-F0-9]{24}$
priority integer required
≥ 0 · ≤ 10000
displayName any optional
Human-readable enrollment token name displayed in dashboard for administrative identification and organizational purposes throughout device lifecycle.
tags array optional
Custom classification labels for enrollment token organization enabling filtering, grouping, and policy automation across device fleet.
managementMode string required
Android Enterprise management mode defining device ownership and control level applied during enrollment process execution.
DEVICE_OWNER PROFILE_OWNER COPE USERLESS
sendEmail any required
Flag controlling whether enrollment instructions and QR code are automatically sent to MDM user email address.
duration integer optional
Enrollment token validity duration in seconds ranging from sixty seconds to thirty days controlling expiration timestamp.
≥ 60 · ≤ 2592000
language string optional
Preferred language code for enrollment notification email localization following ISO standard two-letter country codes.
es en fr de it zh pt ru
emailText any optional
Custom message content appended to enrollment notification email for user-specific instructions or organizational policy communication.
segmentId integer optional
≥ 0 · ≤ 9007199254740991
userEmails array [string] required
List of MDM user email addresses for bulk enrollment token creation generating individual credentials per recipient.
{
    "policyId": "string",
    "emmPolicyAssignments": [
        {
            "emmPolicyId": "string",
            "priority": 0
        }
    ],
    "displayName": "string",
    "tags": [
        "string"
    ],
    "managementMode": "DEVICE_OWNER",
    "sendEmail": true,
    "duration": 0,
    "language": "es",
    "emailText": "string",
    "segmentId": 0,
    "userEmails": [
        "[email protected]"
    ]
}

Responses

200 Response application/json
status boolean optional
data object optional
total number required
Total number of enrollment tokens requested in bulk creation operation for processing tracking and validation.
Format: float
success number required
Count of successfully created enrollment tokens in bulk operation indicating completed provisioning for device distribution.
Format: float
fail number required
Count of failed enrollment token creations in bulk operation requiring investigation for email validation or quota issues.
Format: float
{
    "status": true,
    "data": {
        "total": 10,
        "success": 9,
        "fail": 1
    }
}
400 Response application/json
status boolean optional
false
error object optional
code number optional
5017
message string optional
Limit Exceeded
{
    "status": false,
    "error": {
        "code": 5050,
        "message": "Feature not allowed for you billing plan"
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "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"
    }
}