Authenticate (Twitter)

Authenticate a User using Twitter idToken. This endpoint is used to authenticate users who have logged in using Twitter OAuth. For more details, see our Authentication Methods guide. Refer to the Twitter Auth template script for implementation guidance.

Request Body

application/jsonRequired

authDataRequiredobject

sessionDataRequiredobject

sessionPkClientSignatureRequiredstring

Client signature of the session public key

sessionDataUserSignatureRequiredstring

User signature of the session data

curl -X POST "https://sandbox-api.okto.tech/api/oc/v1/authenticate" \
  -H "Content-Type: application/json" \
  -d '{
    "authData": {
      "idToken": "azdQekVvSmhlbklwUlY0RGY1V2xfbGxaMktTeno1ekhSbDJXRmFqWDU3LW1TOjE3NTAwNTY3OTk5NjM6MToxOmF0OjE",
      "provider": "twitter"
    },
    "sessionData": {
      "nonce": "c0c8916f-3fac-4a48-ac89-2d178abf5313",
      "clientSWA": "0xdb70Faf78B19576d3C969487cb75f5152cee2E8F",
      "sessionPk": "0x0440417e717ea11e98ccd4cc10a8e3b6743c7f50880c0226109611d219d43809aeef018bf572d21df187ecd31f8f866bbfa16fda9dc00f1bc49b184927bdb94889",
      "maxPriorityFeePerGas": "0xBA43B7400",
      "maxFeePerGas": "0xBA43B7400",
      "paymaster": "0x74324fA6Fa67b833dfdea4C1b3A9898574d076e3",
      "paymasterData": "0x000000000000000000000000db70faf78b19576d3c969487cb75f5152cee2e8f0000000000000000000000000000000000000000000000000000000068502774000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000041a636855da104946fdf940c9faf5393e9ff9b7c1b4f15d3bcf32b47770ff38bda3e11bbfb22d4458311cedacde4b3c8de69c3c48d950f22160e5ba1940b996b991b00000000000000000000000000000000000000000000000000000000000000"
    },
    "sessionPkClientSignature": "0xa5783230180426792308bc1fedffcf89f57a61d6efedfd251a21500b0334fe5e45fce0bd86a4e9900306a40a255fe967061283bdf2913ea8873053b44c5a1b2c1b",
    "sessionDataUserSignature": "0xf2d2fec94e4d072577c2b6460427e0ed348363162e3aacf37b47892223c71ec60e53ff4a7a162be82b5621d291f19eb850259ec193533263eacbe4027ed77b951c"
  }'

User Authenticated Successfully

{
  "status": "success",
  "data": {
    "userSWA": "0xE8d11f00Aa2FB0CE06f7BABeE7122D058259E3AF",
    "clientSWA": "0xdb70Faf78B19576d3C969487cb75f5152cee2E8F",
    "nonce": "0x00000000000000000000000000000000c0c8916f3fac4a48ac892d178abf5313",
    "sessionExpiry": 1750925845
  }
}

Authenticate (Twitter)

Request Body

Response

TypeScript