Skip to main content
POST
/
sdk
/
{environmentId}
/
providers
/
{providerType}
/
oauthResult
Returns the authorization code or error retuned by oauth provider
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>"
}
'
{
  "status": "pending",
  "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
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,
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
Example:

"An example name"

sessionPublicKey
string
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

Success

status
enum<string>
required
Available options:
pending,
completed
code
string

Valid oauth code

Example:

"4/0AVHEtk436ug4uWwZN9i2PDpxGTVnLr63IqTNFzTInHce1q2JHQyOCJut9IK2SCZh4JaoSA"

error
string

Error return from oauth provider when user denies access