# Login or Create User by SMS

**POST /v1/auth/otps/sms/login_or_create**

Create an SMS OTP (one-time passcode) to the provided phone number for login verification. If no user account exists for the provided phone number, a new user will be created and OTP sent by SMS.

## HTTP Request

`POST /v1/auth/otps/sms/login_or_create`

## Returns

A successful response returns an object with `user_id`, `user_created` indicating if the user has been newly created, and `phone_number_id` properties.


## Servers
- Production: https://api.moonkey.fun (Production)


## Authentication methods
- Authorization


## Parameters



### Body: application/json (object)

- **phone_number** (string)
  E.164 formatted mobile phone number that uniquely identifies the user.
- **expires_in** (number)
  Expiration time of the OTP in minutes. Must be between 1 to 10 minutes, defaults to 1 minute.
- **requires_verification** (boolean)
  Determines if verification for the authentication method (email, phone_number) is required before marking the user as active.
- **device_fingerprint** (object)
  Device fingerprinting metadata for fraud detection during verification step. This is useful to ensure that the user who originated the request matches the user that verifies the token. Verification requirements can be enabled in the `Verify OTP` step by matching fields in the `device_fingerprint` such as IP, User Agent or the combination of them (more fraud detection features **coming soon**!)


## Responses
### 200
OK

#### Body: application/json (object)
- **phone_number_id** (string)

- **user_created** (boolean)

- **user_id** (string)

- **status** (string)



[Powered by Bump.sh](https://bump.sh)