Get the OAuth provider authorization result

Returns the OAuth authorization result for the given state.

POST /sdk/{environmentId}/providers/{providerType}/oauthResult

Get the OAuth provider authorization result

cURL

curl --request POST \
  --url https://app.dynamicauth.com/api/v0/sdk/{environmentId}/providers/{providerType}/oauthResult \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "state": "<string>",
  "telegramAuthToken": "<string>",
  "forceCreateUser": true,
  "code": "An example name",
  "sessionPublicKey": "An example name",
  "captchaToken": "<string>"
}
'

200

{
  "code": "4/0AVHEtk436ug4uWwZN9i2PDpxGTVnLr63IqTNFzTInHce1q2JHQyOCJut9IK2SCZh4JaoSA",
  "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"

providerType · enum<string> · required

Type of external auth provider The 'turnkey' value is deprecated and will be removed in a future version.

Available options: emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, coinbaseOnramp, cryptoDotCom, moonPay, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify, zksync, kraken, blockaid, passkey, okta, sendgrid, resend

Body

application/json

State string sent to oauth provider from sdk during login

state · string

Temporary auth state for oauth2 access

telegramAuthToken · string

JWT Auth Token coming from Telegram Bot containing user information

forceCreateUser · boolean

Force create a user for Telegram Auto Login

code · string

Pattern: ^(?=\S)[\p{L}\p{N}a-zA-Z _.,:!?&%@\/+\-'|]+(?<=\S)$

Example:

"An example name"

sessionPublicKey · string

Pattern: ^(?=\S)[\p{L}\p{N}a-zA-Z _.,:!?&%@\/+\-'|]+(?<=\S)$

Example:

"An example name"

captchaToken · string

When provided, used to verify that a captcha is valid and get the success/failure result from the captcha provider server-side.

Response

200

application/json

Success

status · enum<string> · required

Available options: pending, completed

code · string

Valid oauth code

Pattern: ^[a-zA-Z0-9_\.\-\/\\%*!+=]{5,1500}$

Example:

"4/0AVHEtk436ug4uWwZN9i2PDpxGTVnLr63IqTNFzTInHce1q2JHQyOCJut9IK2SCZh4JaoSA"

error · string

Error return from oauth provider when user denies access