Create a new Grid smart account with either email-based authentication or custom signer policies. This is the foundation for all Grid operations.

​
Account Types

​
Email Account

Creates an account with email-based authentication:
  • Simplified onboarding process
  • OTP verification required
  • Default signer configuration
  • Suitable for individual users

​
Signers Account

Creates an account with custom policies:
  • Define multiple signers with specific roles
  • Set signature thresholds
  • Configure time locks
  • Suitable for organizations and advanced use cases

​
Account Creation Flow

​
Key Concepts

​
Roles

  • Primary: Main signing authority
  • Backup: Secondary signing authority

​
Permissions

  • CAN_INITIATE: Start operations
  • CAN_VOTE: Approve operations
  • CAN_EXECUTE: Execute transactions

​
Providers

  • privy: Privy MPC provider
  • dynamic: Dynamic MPC provider
  • passkey: WebAuthn passkeys
  • turnkey: Turnkey MPC provider
  • external: External signing service

​
Important Notes

  • Account creation requires an Idempotency-Key header
  • Email accounts require additional OTP verification
  • Signer accounts are immediately available
  • Account addresses are deterministic based on policies
  • Time locks add security delays to sensitive operations