Generate customer-managed enterprise signup URL

POST

/v1/organizations/:organizationId/mdm/android/enterprise/signup-url

Required Permission: mdm.android.enterprise.signupUrlsCreate

Creates a signup URL to initiate customer-managed EMM enterprise registration with Google.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Unique identifier for organization managing Apple enterprise application deployments and configurations.

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

Body Params application/json

adminEmail string optional

Primary contact email address for administrator initiating Google Play enterprise enrollment process required for sending signup instructions and managing enterprise configuration.

≤ 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

allowedDomains array [string] optional

List of allowed email domains restricting enterprise enrollment to users with matching email addresses ensuring organizational control over access.

{
    "adminEmail": "[email protected]",
    "allowedDomains": [
        "string"
    ]
}

Responses

200 Response application/json

status boolean required

data object required

redirectUrl string optional

Google-generated signup URL redirecting administrators to Android Enterprise enrollment workflow for customer-managed enterprise creation.

≤ 500 characters

{
    "status": true,
    "data": {
        "redirectUrl": "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": 5046,
        "message": "Android Emm Enterprise already exists for this organization"
    }
}

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"
    }
}