# requestFirstPartyAuthorizationChallenge (/docs/auth/api/functions/requestFirstPartyAuthorizationChallenge)



[@kysoql/auth](/docs/auth/api) / requestFirstPartyAuthorizationChallenge

```ts
function requestFirstPartyAuthorizationChallenge(options): Promise<FirstPartyAuthorizationChallenge>;
```

Calls the OAuth 2.0 for First-Party Applications authorization-challenge
endpoint. The generic parameter bag intentionally follows Salesforce because
login, passwordless, registration, reCAPTCHA, and continuation steps require
different documented fields.

## Parameters [#parameters]

| Parameter | Type                                                                                                           |
| --------- | -------------------------------------------------------------------------------------------------------------- |
| `options` | [`FirstPartyAuthorizationChallengeOptions`](/docs/auth/api/interfaces/FirstPartyAuthorizationChallengeOptions) |

## Returns [#returns]

`Promise`\<[`FirstPartyAuthorizationChallenge`](/docs/auth/api/type-aliases/FirstPartyAuthorizationChallenge)>