Create a visit

Endpoint to send minimal wallet information for a connect-only or connect-first visitor.

POST /sdk/{environmentId}/connect

Create a visit

cURL

curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/connect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "address": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
  "chain": "ETH",
  "provider": "browserExtension",
  "walletName": "<string>",
  "authMode": "connect-only"
}
'

400

{
  "error": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

environmentId · string · required

ID of the environment

Required string length: 36

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

Body

application/json

Connected Visit data

address · string · required

Valid blockchain wallet address, must be an alphanumeric string without any special characters

Maximum string length: 255

Pattern: ^[A-Za-z0-9]{18,100}$

Example:

"0xbF394748301603f18d953C90F0b087CBEC0E1834"

chain · enum<string> · required

Available options: ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE, SUI, SPARK, TRON, APTOS, TON, STELLAR

provider · enum<string> · required

Available options: browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet

walletName · string · required

Maximum string length: 255

authMode · enum<string>

Available options: connect-only, connect-and-sign

Response

202

Accepted