API Reference/Social Login (OAuth)
POST
/v1/auth/oauth/authorize

Authorization

AuthorizationRequiredBearer <token>

In: header

Request Body

application/jsonRequired
stepupboolean
Default: false
customClaimsobject
mfaboolean
Default: false
ssoAppIdstring
templateOptionsobject
localestring
pkceChallengestring

relevant only for enchanted links in the point in time - other methods will ignore this field

Format: "bytes"
revokeOtherSessionsboolean

Query Parameters

providerstring
redirectUrlstring
promptarray<string>
testboolean
rawResponseboolean
curl -X POST "https://api.descope.com/v1/auth/oauth/authorize?provider=string&redirectUrl=string" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "stepup": false,
    "customClaims": {},
    "mfa": false,
    "ssoAppId": "string",
    "templateOptions": {
      "property1": "string",
      "property2": "string"
    },
    "locale": "string",
    "pkceChallenge": "string",
    "revokeOtherSessions": true
  }'

OK

{
  "url": "string",
  "errorId": "string"
}

Was this helpful?

OAuth Social Login API Overview

Use the Descope REST API to build OAuth social logins for your application.

Create Redirect URI for Sign-In Request POST

### Create an OAuth Redirect URI for user Sign-In Request This endpoint allows you to create an OAuth Redirect URI for user Sign-Up Request. ### See Also - See [The User Object](/api/overview#the-user-object) for further details on how to identify users and their contact information such as email addresses and phone number. ### Endpoint Authentication Use authorization bearer header with the following format: `Authorization: Bearer <Project ID>`