# CreatePasswordRequest

Artifact: [androidx.credentials:credentials](https://developer.android.com/jetpack/androidx/releases/credentials) [View Source](https://cs.android.com/search?q=file:androidx/credentials/CreatePasswordRequest.kt+class:androidx.credentials.CreatePasswordRequest) Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/credentials#1.2.0)

*** ** * ** ***

<br />

```
public final class CreatePasswordRequest extends CreateCredentialRequest
```

<br />

|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object.html) |||
| ↳ | [androidx.credentials.CreateCredentialRequest](https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest) ||
|   | ↳ | [androidx.credentials.CreatePasswordRequest](https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest) |

*** ** * ** ***

A request to save the user password credential with their password provider.

## Summary

| ### Public constructors |
|---|
| `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#CreatePasswordRequest(kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)( @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html id, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html password, https://developer.android.com/reference/java/lang/String.html origin, boolean preferImmediatelyAvailableCredentials, boolean isAutoSelectAllowed )` Constructs a `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest` to save the user password credential with their password provider. |
| `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#CreatePasswordRequest(kotlin.String,kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)( @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html id, @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html password, https://developer.android.com/reference/java/lang/String.html origin, https://developer.android.com/reference/java/lang/String.html preferDefaultProvider, boolean preferImmediatelyAvailableCredentials, boolean isAutoSelectAllowed )` Constructs a `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest` to save the user password credential with their password provider. |

| ### Public methods |
|---|---|
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#getId()()` the user id associated with the password |
| `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html` | `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#getPassword()()` the password |

### Inherited methods

From [androidx.credentials.CreateCredentialRequest](https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest) `final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/android/os/Bundle.html` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#getCandidateQueryData()()`

the partial request data in the `https://developer.android.com/reference/android/os/Bundle.html` format that will be sent to the provider during the initial candidate query stage, which should not contain sensitive user credential information (note: bundle keys in the form of `androidx.credentials.*` are reserved for internal library use)
`final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/android/os/Bundle.html` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#getCredentialData()()`

the request data in the `https://developer.android.com/reference/android/os/Bundle.html` format
`final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest.DisplayInfo` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#getDisplayInfo()()`

the information to be displayed on the screen
`final https://developer.android.com/reference/java/lang/String.html` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#getOrigin()()`

the origin of a different application if the request is being made on behalf of that application (Note: for API level \>=34, setting a non-null value for this parameter will throw a SecurityException if android.permission.CREDENTIAL_MANAGER_SET_ORIGIN is not present)
`final @https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#getType()()`

the credential type determined by the credential-type-specific subclass (e.g. the type for `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest` is `https://developer.android.com/reference/androidx/credentials/PasswordCredential#TYPE_PASSWORD_CREDENTIAL()` and for `https://developer.android.com/reference/androidx/credentials/CreatePublicKeyCredentialRequest` is `https://developer.android.com/reference/androidx/credentials/PublicKeyCredential#TYPE_PUBLIC_KEY_CREDENTIAL()`)
`final boolean` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#isAutoSelectAllowed()()`

whether a create option will be automatically chosen if it is the only one available to the user
`final boolean` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#isSystemProviderRequired()()`

true if must only be fulfilled by a system provider and false otherwise
`final boolean` `https://developer.android.com/reference/androidx/credentials/CreateCredentialRequest#preferImmediatelyAvailableCredentials()()`

true if you prefer the operation to return immediately when there is no available passkey registration offering instead of falling back to discovering remote options, and false (preferred by default) otherwise

## Public constructors

### CreatePasswordRequest

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/credentials#1.2.0)

```
public CreatePasswordRequest(
    @NonNull String id,
    @NonNull String password,
    String origin,
    boolean preferImmediatelyAvailableCredentials,
    boolean isAutoSelectAllowed
)
```

Constructs a `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest` to save the user password credential with their password provider.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html id` | the user id associated with the password |
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html password` | the password |
| `https://developer.android.com/reference/java/lang/String.html origin` | the origin of a different application if the request is being made on behalf of that application (Note: for API level \>=34, setting a non-null value for this parameter will throw a SecurityException if android.permission.CREDENTIAL_MANAGER_SET_ORIGIN is not present) |
| `boolean preferImmediatelyAvailableCredentials` | true if you prefer the operation to return immediately when there is no available password saving option instead of falling back to discovering remote options, and false (default) otherwise |
| `boolean isAutoSelectAllowed` | whether a create option will be automatically chosen if it is the only one available to the user (note that there is a chance that the credential provider does not support auto-select even if you turn this bit on); not recommended to be true for password request type to ensure that the user will always get a confirmation dialog even if the password saving provider does not offer any UI |

| Throws |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-null-pointer-exception/index.html` | If `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is null |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-null-pointer-exception/index.html` | If `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is null |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-illegal-argument-exception/index.html` | If `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is empty |
| `https://developer.android.com/reference/java/lang/SecurityException.html` | if `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is set but android.permission.CREDENTIAL_MANAGER_SET_ORIGIN is not present |

### CreatePasswordRequest

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/credentials#1.2.0)

```
public CreatePasswordRequest(
    @NonNull String id,
    @NonNull String password,
    String origin,
    String preferDefaultProvider,
    boolean preferImmediatelyAvailableCredentials,
    boolean isAutoSelectAllowed
)
```

Constructs a `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest` to save the user password credential with their password provider.

| Parameters |
|---|---|
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html id` | the user id associated with the password |
| `@https://developer.android.com/reference/androidx/annotation/NonNull https://developer.android.com/reference/java/lang/String.html password` | the password |
| `https://developer.android.com/reference/java/lang/String.html origin` | the origin of a different application if the request is being made on behalf of that application (Note: for API level \>=34, setting a non-null value for this parameter will throw a SecurityException if android.permission.CREDENTIAL_MANAGER_SET_ORIGIN is not present) |
| `https://developer.android.com/reference/java/lang/String.html preferDefaultProvider` | the preferred default provider component name to prioritize in the selection UI flows (Note: your app must have the permission android.permission.CREDENTIAL_MANAGER_SET_ALLOWED_PROVIDERS to specify this, or it would not take effect; also this bit may not take effect for Android API level 33 and below, depending on the pre-34 provider(s) you have chosen) |
| `boolean preferImmediatelyAvailableCredentials` | true if you prefer the operation to return immediately when there is no available passkey registration offering instead of falling back to discovering remote options, and false (preferably) otherwise |
| `boolean isAutoSelectAllowed` | whether a create option will be automatically chosen if it is the only one available to the user (note that there is a chance that the credential provider does not support auto-select even if you turn this bit on); not recommended to be true for password request type to ensure that the user will always get a confirmation dialog even if the password saving provider does not offer any UI |

| Throws |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-null-pointer-exception/index.html` | If `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is null |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-null-pointer-exception/index.html` | If `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is null |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-illegal-argument-exception/index.html` | If `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is empty |
| `https://developer.android.com/reference/java/lang/SecurityException.html` | if `https://developer.android.com/reference/androidx/credentials/CreatePasswordRequest#(kotlin.String,kotlin.String,kotlin.String,kotlin.String,kotlin.Boolean,kotlin.Boolean)` is set but android.permission.CREDENTIAL_MANAGER_SET_ORIGIN is not present |

## Public methods

### getId

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/credentials#1.2.0)

```
public final @NonNull String getId()
```

the user id associated with the password

### getPassword

Added in [1.2.0](https://developer.android.com/jetpack/androidx/releases/credentials#1.2.0)

```
public final @NonNull String getPassword()
```

the password