Skip to main content
Onboarding provisions your organization-owned Turnkey authority, registers its MicroVault account on Ethereum Sepolia, and activates that account. Run it once before creating a vault. Repeating the request resumes the same onboarding workflow.

Prerequisites

  • A Ground sandbox API key for an organization with MicroVaults enabled

1. Start onboarding

Send an empty JSON object. Do not supply an authority address or other configuration.
The response reports the current stage. provisioning, registering, and activating mean onboarding is still progressing. active means the organization is ready.

2. Wait for the managed authority

Poll the authority endpoint until it returns status: "ready" and a non-null address.

3. Save the MicroVault account ID

List the organization’s account records and select the Ethereum Sepolia record with status: "accepted".
Save customers[0].id as CUSTOMER_ID. You will use it when preparing vault authorizations.

Confirm onboarding

Onboarding is complete when all three conditions are true:
  • POST /onboarding returns status: "active".
  • GET /managed-authority returns status: "ready" with an authority address.
  • GET /customers contains an Ethereum Sepolia record with status: "accepted".
If onboarding remains in an intermediate state, call POST /onboarding again with {} and continue polling. A 503 means provisioning is temporarily unavailable; retry the same request rather than creating a second authority.