Authentication

Verify email OTP and get JWT

Verifies the 6-digit code sent to the user's email. Optionally auto-provisions treasury wallets for the specified chains. Returns a JWT for subsequent API calls.

An unrecognized address is rejected unless the request carries platform_app_id or sets allow_signup.

post/v1/auth/email-otp/verify

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/auth/email-otp/verify
  • Auth: none required

Request body

emailstring email required
codestring required

6-digit OTP code

platform_app_idstring uuid
auto_provision_chainsstring[]

Chains to auto-generate wallets for (e.g. ["ethereum", "base"])

allow_signupboolean

Opt in to creating an account when the address is not recognized. Without it an unknown address is rejected rather than silently given a new user and org — a valid code proves control of an inbox, not consent to sign up. Not required when platform_app_id is present: creating the end user on first login is the embedded-wallet flow.

Response

Existing user authenticated

tokenstring required

JWT access token

user_idstring uuid required
org_idstring uuid required
is_new_userboolean required
emailstring email required
wallet_addressstring nullable

Ethereum address if auto_provision_chains included an EVM chain

Changes

No recorded changes to this operation across all 1 revision of this API.