tenant_Google Enterprise

Generate sign-up URL

Generates a Google EMM sign-up URL to begin enterprise enrollment.

Starts the Google EMM enrollment flow by generating a sign-up URL that the tenant admin visits to bind their organization to Google's Enterprise Mobility Management infrastructure; callback_url specifies where Google redirects after sign-up.

About Google EMM Enrollment Enrolling in Google EMM is a prerequisite for managing GMS-enabled Android devices (silent app install, managed Play Store, managed configurations). This endpoint is the first step of that enrollment flow, generating the URL that begins the Google-hosted sign-up process.

Key Fields / Query Parameters

  • callback_url — URL Google redirects to after the admin completes sign-up

Common Use Cases

  • Kicking off Google EMM enrollment for a new tenant during onboarding
  • Building a custom onboarding UI that embeds Google's enrollment sign-up flow
  • Re-initiating enrollment if a previous attempt was abandoned before completion

Best Practices

  • Ensure callback_url is reachable and correctly handles the completion_token/enterprise_token Google returns
  • Complete the flow promptly — sign-up URLs and tokens are typically time-limited
  • Store the resulting tokens securely, since they're required to complete enrollment

Workflow

  1. POST a callback_url to this endpoint to receive the Google sign-up URL
  2. Direct the tenant admin to that URL to complete sign-up on Google's side
  3. Handle the redirect to callback_url and call POST /v2/emm/enrollment/complete/ with the returned tokens
post/v2/emm/enrollment/begin/

Request

  • Base URL
    https://develop-api.esper.cloud/api
  • URL
    https://develop-api.esper.cloud/api/v2/emm/enrollment/begin/
  • Auth
    none declared. Required headers: Authorization

Headers

Authorizationstring required

Bearer token for authorization

Request body

callback_urlstring required

Response

Successfully generated sign-up URL

signup_urlstring
completion_tokenstring

Changes

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