Skip to main content
POST
/
api
/
v1
/
passkeys
/
externally-signed-account
Get externally signed account from authenticator response
curl --request POST \
  --url https://developer-api.squads.so/api/v1/passkeys/externally-signed-account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-squads-network: <x-squads-network>' \
  --data '{
  "authenticatorResponse": {},
  "metaInfo": {
    "redirectUrl": "<string>"
  }
}'
{
  "externallySignedAccount": "<string>",
  "sessionKey": {
    "key": "<string>",
    "expiration": 123
  },
  "redirectUrl": "<string>"
}
Retrieves an externally signed account from a WebAuthn authenticator response. This is an advanced endpoint for companies that need to host passkey flows on their own domain. For most applications, use the hosted UI approach instead.

​
Key Notes

  • Custom Domain: Use this endpoint when hosting passkey flows on your own domain
  • Complete Response Required: Submit the full WebAuthn authenticator response object
  • Existing Passkeys: Works with previously registered passkeys
For detailed implementation, see the Custom Domain guide.

Authorizations

​
Authorization
string
header
required

UUID-based API key provided by Squads

Headers

​
x-squads-network
enum<string>
required

Specifies the network for the API request

Available options:
mainnet,
devnet

Body

application/json
​
authenticatorResponse
object
required

Complete WebAuthn authenticator response as JSON value

​
metaInfo
object

Optional metadata information

Response

Externally signed account retrieved successfully

​
externallySignedAccount
string

Solana public key of the externally signed account

​
sessionKey
object

Optional session key information

​
redirectUrl
string

Optional redirect URL

⌘I