Skip to main content
POST
/
api
/
grid
/
v1
/
auth
Initiate email authentication
curl --request POST \
  --url https://grid.squads.xyz/api/grid/v1/auth \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "smart_account_address": "<string>"
}
'
{
  "created_at": "2023-11-07T05:31:56Z",
  "email": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "otp_sent": true,
  "status": "<string>",
  "type": "<string>",
  "fallback_reason": "<string>",
  "otp_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://developers.squads.so/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint is for authenticating an existing user. For new users, use the Create Account endpoint.

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

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