Create EMM-managed enterprise

POST

/v1/organizations/:organizationId/mdm/android/enterprise/

Create EMM-managed enterprise

Required Permission: mdm.android.enterprise.create

Creates a new EMM-managed enterprise with specified configuration and contact information.

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

enterpriseDisplayName string required

User-facing enterprise name displayed within Google Play managed configurations interface and enrollment workflows visible to end users.

≤ 256 characters

contactInfo object required

Enterprise contact information including data protection officers and EU representatives required for GDPR compliance and user support.

contactEmail string required

Primary contact email address for enterprise administrative communications and support requests visible to managed device users.

≤ 256 characters

dataProtectionOfficerName string required

Full name of data protection officer responsible for GDPR compliance and privacy oversight required for EU operations.

≤ 256 characters

dataProtectionOfficerEmail string required

Email address of data protection officer enabling direct contact for privacy inquiries and data subject access requests.

≤ 256 characters

dataProtectionOfficerPhone string required

Phone number of data protection officer providing alternative communication channel for urgent privacy-related matters and compliance issues.

≤ 256 characters

euRepresentativeName string required

Full name of EU representative designated for GDPR Article 27 requirements when enterprise lacks EU establishment.

≤ 256 characters

euRepresentativeEmail string required

Email address of EU representative enabling contact for data protection matters within European Economic Area jurisdictions.

≤ 256 characters

euRepresentativePhone string required

Phone number of EU representative providing communication channel for supervisory authorities and data subjects within EU.

≤ 256 characters

configuration object required

Initial enterprise branding configuration including logo, colors, and contact details applied during EMM-managed enterprise provisioning.

primaryColor string optional

Hexadecimal color code or integer representation defining primary brand color for enrollment interfaces and management applications.

≤ 256 characters

logo string optional

URL or base64-encoded image data for enterprise logo displayed throughout device enrollment and management workflows.

contactEmail string optional

Primary contact email address for enterprise administrative communications and support requests visible to managed device users.

≤ 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

contactPhone string optional

Enterprise support phone number displayed to managed device users for technical assistance and administrative inquiries.

≤ 256 characters

{
    "enterpriseDisplayName": "string",
    "contactInfo": {
        "contactEmail": "string",
        "dataProtectionOfficerName": "string",
        "dataProtectionOfficerEmail": "string",
        "dataProtectionOfficerPhone": "string",
        "euRepresentativeName": "string",
        "euRepresentativeEmail": "string",
        "euRepresentativePhone": "string"
    },
    "configuration": {
        "primaryColor": "string",
        "logo": "string",
        "contactEmail": "[email protected]",
        "contactPhone": "string"
    }
}

Responses

200 Response application/json

status boolean required

data object required

id string required

Unique identifier for the EMM enterprise record enabling cross-reference operations between local database and Google Android Management API resources.

Match pattern: ^[a-fA-F0-9]{24}$

config object required

Enterprise configuration object containing Google-synchronized settings for branding, authentication, and operational parameters.

name string optional

Internal enterprise name used for administrative identification within the platform backend systems distinct from user-facing display labels.

≤ 128 characters

enterpriseDisplayName string optional

User-facing enterprise name displayed within Google Play managed configurations interface and enrollment workflows visible to end users.

≤ 256 characters

logo any optional

Enterprise branding logo configuration containing image URL and content hash for visual customization of enrollment and management interfaces.

primaryColor integer optional

Integer representation of primary brand color in ARGB format applied to enrollment screens and management interface elements.

≥ 0 · ≤ 9007199254740991

termsAndConditions array optional

Legal agreements and usage policies presented to users during device enrollment requiring acknowledgment before granting access.

enterpriseType string optional

Google enterprise configuration type indicating operational mode as either customer-managed or EMM-managed affecting ownership and control boundaries.

managedGooglePlayAccountsEnterpriseType string optional

Managed Google Play account type defining user account provisioning model and authentication requirements for application distribution workflows.

managedGoogleDomainType string optional

Google domain management type specifying organization's authentication relationship with Google Workspace affecting sign-in policies and account restrictions.

googleAuthenticationSettings any optional

Authentication policy configuration controlling Google account sign-in requirements and restrictions for managed device access.

error string optional

Error code indicating enterprise configuration or synchronization failure requiring administrative intervention for resolution.

unauthorized

_config any optional

Raw enterprise configuration object from Google Android Management API preserved for debugging and advanced troubleshooting scenarios.

adminEmail string optional

≤ 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

updatedAt string required

Timestamp recording most recent enterprise configuration modification enabling change tracking and audit trail maintenance.

createdAt string required

Timestamp marking initial enterprise creation providing foundational audit record and enabling lifecycle analysis.

{
    "status": true,
    "data": {
        "id": "string",
        "config": {
            "name": "string",
            "enterpriseDisplayName": "string",
            "logo": "string",
            "primaryColor": 0,
            "termsAndConditions": [
                "string"
            ],
            "enterpriseType": "string",
            "managedGooglePlayAccountsEnterpriseType": "string",
            "managedGoogleDomainType": "string",
            "googleAuthenticationSettings": "string"
        },
        "error": "unauthorized",
        "_config": "string",
        "adminEmail": "[email protected]",
        "updatedAt": "string",
        "createdAt": "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"
    }
}