Skip to content

Generate sign-up URL
Stable

Request

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
Headers
Authorizationstringrequired

Bearer token for authorization

Bodyapplication/jsonrequired
callback_urlstringrequired
cURL
curl -i -X POST \
  https://develop-api.esper.io/_mock/openapi/v2/emm/enrollment/begin/ \
  -H 'Authorization: string' \
  -H 'Content-Type: application/json' \
  -d '{
    "callback_url": "string"
  }'

Responses

Successfully generated sign-up URL

Bodyapplication/json
signup_urlstring
completion_tokenstring
Response
{
  "signup_url": "string",
  "completion_token": "string"
}