Skip to content

Complete EMM enrollment for a Google Enterprise
Stable

Request

Completes Google EMM enrollment for a Google Enterprise.

Finalizes enrollment using the completion_token and enterprise_token returned by Google after the admin completed sign-up, activating the Google Enterprise binding for the tenant.

About Google EMM Enrollment This is the second and final step of the Google EMM enrollment flow, following POST /v2/emm/enrollment/begin/ and the admin completing sign-up on Google's hosted page.

Key Fields / Query Parameters

  • completion_token — Token returned by Google after sign-up completion
  • enterprise_token — Token returned by Google identifying the enterprise binding

Common Use Cases

  • Finalizing enrollment as the callback step after an admin completes Google's sign-up flow
  • Completing enrollment programmatically in a custom onboarding integration
  • Retrying completion if an earlier attempt failed transiently

Best Practices

  • Call this promptly after receiving the tokens from Google's redirect, since they are typically time-limited
  • Handle failures by checking enrollment status (GET /v2/emm/details/) rather than assuming the tokens can be reused indefinitely
  • Do not log completion_token/enterprise_token in plaintext

Workflow

  1. Receive completion_token and enterprise_token via the callback_url redirect from Google
  2. POST both tokens to this endpoint to finalize enrollment
  3. Confirm success via GET /v2/emm/details/
Headers
Authorizationstringrequired

Bearer token for authorization

Bodyapplication/jsonrequired
completion_tokenstringrequired
enterprise_tokenstringrequired
cURL
curl -i -X POST \
  https://develop-api.esper.io/_mock/openapi/v2/emm/enrollment/complete/ \
  -H 'Authorization: string' \
  -H 'Content-Type: application/json' \
  -d '{
    "completion_token": "string",
    "enterprise_token": "string"
  }'

Responses

Successfully completed EMM enrollment

Bodyapplication/json
idinteger
google_enterprise_idstring
namestring
stateinteger
callback_urlstring
signup_urlstring
completion_tokenstring
enterprise_tokenstring
created_atstring, (date-time)
updated_atstring, (date-time)
tenant_idstring
Response
{
  "id": 0,
  "google_enterprise_id": "string",
  "name": "string",
  "state": 0,
  "callback_url": "string",
  "signup_url": "string",
  "completion_token": "string",
  "enterprise_token": "string",
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z",
  "tenant_id": "string"
}