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



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

```ts
function requestDeviceAuthorization(options): Promise<DeviceAuthorization>;
```

Starts Salesforce's OAuth 2.0 device flow.

## Parameters [#parameters]

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

## Returns [#returns]

`Promise`\<[`DeviceAuthorization`](/docs/auth/api/interfaces/DeviceAuthorization)>