Initiate email authentication

Start the authentication process by sending an OTP to the provided email address. Includes automatic provider fallback: if the requested provider (default: Privy) is unavailable or times out, the endpoint falls back to the alternate provider. When a fallback occurs, the response includes requested_provider (the originally requested provider) and fallback_reason (timeout or provider_error).

POST /api/grid/v1/auth

Initiate email authentication

cURL

curl --request POST \
  --url https://grid.squads.xyz/api/grid/v1/auth \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "provider": "privy",
  "smart_account_address": "<string>"
}
'

202

{
  "created_at": "2023-11-07T05:31:56Z",
  "email": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "otp_sent": true,
  "provider": "privy",
  "status": "<string>",
  "type": "<string>",
  "fallback_reason": "<string>",
  "otp_id": "<string>",
  "requested_provider": "privy"
}

Authorizations

Authorization · string · header · required

Your Grid API key from the Grid Dashboard

Body

application/json

email · string · required

provider · null | enum<string>

Available options: privy, dynamic, passkey, turnkey, external

smart_account_address · string | null

Response

202

application/json

OTP sent successfully

created_at · string<date-time> · required

email · string · required

expires_at · string<date-time> · required

otp_sent · boolean · required

provider · enum<string> · required

Available options: privy, dynamic, passkey, turnkey, external

status · string · required

type · string · required

fallback_reason · string | null

otp_id · string | null

requested_provider · null | enum<string>

Available options: privy, dynamic, passkey, turnkey, external