@loopback/docs/site/apidocs/authentication.useridentityservice.findorcreateuser.md

Documentation files rendered at [https://loopback.io](https://loopback.io)

---
lang: en
title: 'API docs: authentication.useridentityservice.findorcreateuser'
keywords: LoopBack 4.0, LoopBack 4, Node.js, TypeScript, OpenAPI
sidebar: lb4_sidebar
editurl: https://github.com/loopbackio/loopback-next/tree/master/packages/authentication
permalink: /doc/en/lb4/apidocs.authentication.useridentityservice.findorcreateuser.html
---

<!-- Do not edit this file. It is automatically generated by API Documenter. -->

[Home](./index.md) &gt; [@loopback/authentication](./authentication.md) &gt; [UserIdentityService](./authentication.useridentityservice.md) &gt; [findOrCreateUser](./authentication.useridentityservice.findorcreateuser.md)

## UserIdentityService.findOrCreateUser() method

find or create a local user using a profile from an external source

**Signature:**

```typescript
findOrCreateUser(userIdentity: I): Promise<U>;
```

## Parameters

<table><thead><tr><th>

Parameter


</th><th>

Type


</th><th>

Description


</th></tr></thead>
<tbody><tr><td markdown="1">

userIdentity


</td><td markdown="1">

I


</td><td markdown="1">


</td></tr>
</tbody></table>

**Returns:**

Promise&lt;U&gt;

## Example

async findOrCreateUser( ldapUser: LDAPUserIdentity, ): Promise<UserProfile> { let user: UserProfile = await this.userRepository.findOrCreate(<!-- -->{ name: ldapUser.cn, username: ldapUser.mail, roles: \_.map(ldapUser.memberof\['ou=roles,dc=mydomain,o=myOrg'\], 'cn') }<!-- -->); await this.linkExternalProfile(user.id, ldapUser); return user; }