Create bulk enrollment tokens

POST

/v1/organizations/:organizationId/mdm/android/enterprise/enrollment-tokens/bulk

Create bulk enrollment tokens

Required Permission: mdm.android.enrollmentToken.create

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

Request

Add parameter in 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 boolean 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"
    }
}