This call sends information that you have specified about the user to Amazon Pinpoint. This could be for an unauthenticated or an authenticated user.

In addition, `customProperties` and `userAttributes` can also be provided when invoking `identifyUser`. The Amazon Pinpoint console makes that data available as part of the criteria for segment creation. Attributes passed in via `customProperties` will appear under **Custom Endpoint Attributes**, while `userAttributes` will appear under **Custom User Attributes**. See the [Pinpoint documentation](https://docs.aws.amazon.com/pinpoint/latest/userguide/segments-building.html#choosecriteria) for more information on segment creation.

You can get the current user's ID from the Amplify Auth category as shown below. Be sure you have it added and setup per the [Auth category documentation](/lib/auth/getting-started).

If you have asked for location access and received permission, you can also provide that in `UserProfile.Location`.

<BlockSwitcher>
<Block name="Java">

```java
UserProfile.Location location = UserProfile.Location.builder()
    .latitude(47.606209)
    .longitude(-122.332069)
    .postalCode("98122")
    .city("Seattle")
    .region("WA")
    .country("USA")
    .build();

AnalyticsProperties customProperties = AnalyticsProperties.builder()
    .add("property1", "Property value")
    .build();

AnalyticsProperties userAttributes = AnalyticsProperties.builder()
    .add("someUserAttribute", "User attribute value")
    .build();

AWSPinpointUserProfile profile = AWSPinpointUserProfile.builder()
    .name("test-user")
    .email("user@test.com")
    .plan("test-plan")
    .location(location)
    .customProperties(customProperties)
    .userAttributes(userAttributes)
    .build();

Amplify.Auth.getCurrentUser(authUser -> {
    String userId = authUser.getUserId();
    Amplify.Analytics.identifyUser(userId, profile);
}, exception -> {
    Log.e("MyAmplifyApp", "Error getting current user", exception);
});


```

</Block>
<Block name="Kotlin">

```kotlin
val location = UserProfile.Location.builder()
    .latitude(47.606209)
    .longitude(-122.332069)
    .postalCode("98122")
    .city("Seattle")
    .region("WA")
    .country("USA")
    .build();

val customProperties = AnalyticsProperties.builder()
    .add("property1", "Property value")
    .build();

val userAttributes = AnalyticsProperties.builder()
    .add("someUserAttribute", "User attribute value")
    .build();

val profile = AWSPinpointUserProfile.builder()
    .name("test-user")
    .email("user@test.com")
    .plan("test-plan")
    .location(location)
    .customProperties(customProperties)
    .userAttributes(userAttributes)
    .build();

Amplify.Auth.getCurrentUser({ authUser ->
    Amplify.Analytics.identifyUser(authUser.userId, profile);
}, { exception ->
    Log.e("MyAmplifyApp", "Error getting current user", exception)
})
```

</Block>
<Block name="RxJava">

```java
UserProfile.Location location = UserProfile.Location.builder()
    .latitude(47.606209)
    .longitude(-122.332069)
    .postalCode("98122")
    .city("Seattle")
    .region("WA")
    .country("USA")
    .build();

AnalyticsProperties customProperties = AnalyticsProperties.builder()
    .add("property1", "Property value")
    .build();

AnalyticsProperties userAttributes = AnalyticsProperties.builder()
    .add("someUserAttribute", "User attribute value")
    .build();

AWSPinpointUserProfile profile = AWSPinpointUserProfile.builder()
    .name("test-user")
    .email("user@test.com")
    .plan("test-plan")
    .location(location)
    .customProperties(customProperties)
    .userAttributes(userAttributes)
    .build();

RxAmplify.Auth.getCurrentUser()
    .subscribe(
        result -> {
            String userId = result.getUserId();
            RxAmplify.Analytics.identifyUser(userId, profile);
        },
        error -> Log.e("AuthQuickStart", error.toString())
    );
```

</Block>
</BlockSwitcher>

import android0 from "/src/fragments/lib/analytics/native_common/identify-use-cases.mdx";

<Fragments fragments={{android: android0}} />