v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-137790167.2 KB
users

Creates a new EMM-managed user. The Users resource passed in the body of the request should include an accountIdentifier and an accountType. If a corresponding user already exists with the same account identifier, the user will be updated with the resource. In this case only the displayName field can be changed.

post/androidenterprise/v1/enterprises/{enterpriseId}/users

Path parameters

enterpriseIdstring required

The ID of the enterprise.

Request body

accountType'deviceAccount' | 'userAccount'

The type of account that this user represents. A userAccount can be installed on multiple devices, but a deviceAccount is specific to a single device. An EMM-managed user (emmManaged) can be either type (userAccount, deviceAccount), but a Google-managed user (googleManaged) is always a userAccount.

accountIdentifierstring

A unique identifier you create for this user, such as "user342" or "asset#44418". Do not use personally identifiable information (PII) for this property. Must always be set for EMM-managed users. Not set for Google-managed users.

idstring

The unique ID for the user.

primaryEmailstring

The user's primary email address, for example, "jsmith@example.com". Will always be set for Google managed users and not set for EMM managed users.

displayNamestring

The name that will appear in user interfaces. Setting this property is optional when creating EMM-managed users. If you do set this property, use something generic about the organization (such as "Example, Inc.") or your name (as EMM). Not used for Google-managed user accounts. @mutable androidenterprise.users.update

managementType'googleManaged' | 'emmManaged'

The entity that manages the user. With googleManaged users, the source of truth is Google so EMMs have to make sure a Google Account exists for the user. With emmManaged users, the EMM is in charge.

Response

Successful response