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.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 returnsstatus: "ready" and a non-null address.
3. Save the MicroVault account ID
List the organization’s account records and select the Ethereum Sepolia record withstatus: "accepted".
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 /onboardingreturnsstatus: "active".GET /managed-authorityreturnsstatus: "ready"with an authority address.GET /customerscontains an Ethereum Sepolia record withstatus: "accepted".
POST /onboarding again with {} and continue polling. A 503 means provisioning is temporarily unavailable; retry the same request rather than creating a second authority.