device_Device Enrollment in EMM

Create a Google user and, if request body is not provided, generate a Google auth token for a specific device on the Google EMM side.

⚠️ Android only.

Creates a Google EMM user for a device and links it in Esper.

With no request body, Esper creates the Google user on the Google EMM side and generates an authentication token for the device. Check for an existing account with GET first to avoid duplicates.

About Creating a Device Google Account Esper normally creates this account during enrollment. Use this endpoint when a device enrolled without one.

Key Fields / Query Parameters

  • deviceId — UUID of the device
  • Request body (optional) — When included, tenant_id, google_user_id, device_id, and account_type are required
post/v2/devices/{deviceId}/google-accounts/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/v2/devices/{deviceId}/google-accounts/
  • Auth
    none declared

Path parameters

deviceIdstring uuid required

The unique identifier of the device for which Google account details need to be updated.

Request body

tenant_idstring uuid required

The ID of the tenant associated with the Google account.

google_user_idstring required

The unique identifier for the Google user.

device_idstring uuid required

The ID of the device associated with the Google account.

google_device_idstring

The unique identifier for the Google device.

account_identifierstring

An identifier for the account.

account_typeinteger required

The type of the Google account.

google_authentication_tokenstring

The authentication token for the Google account.

created_atstring date-time

The timestamp when the Google account was created.

updated_atstring date-time

The timestamp when the Google account was last updated.

Response

Successfully updated the Google account details.

Changes

No recorded changes to this operation across all 6 revisions of this API.