---
title: "Create simple login"
method: POST
path: "/auth/v3/createSimpleLogin"
tags: ["Retail"]
---

# Create simple login

`POST /auth/v3/createSimpleLogin`

Simple Login allows trusted users to proceed directly to the retail/MOTO iframe without entering a Nexio username and password. This option is useful for cases in which multiple users will be using a single Nexio account. It can also save time for internal users by eliminating the need to enter a username and password upon each use.

Use the `key` value from the response as a query parameter in the request to load Nexio's retail iframe. For additional information about using this endpoint, see the [Using simple login for authentication](https://docs.nexiopay.com/docs/using-simple-login-for-authentication) tutorial.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you must use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments) that you want to use for transactions and other tasks with the retail iframe.

<div style="display:none;">

## Response parameters
- exp
- jwt
- key
- refreshToken
- username

</div>

## Response `200`

Success

- object
  - `username` string — The simple login username.
  - `exp` integer — The date and time at which the Simple Login will expire, presented an a UNIX date (an integer representing seconds).
  - `key` string — The simple login key. A key can only be used once and expires after one hour.
  - `jwt` string — The JSON Web Token
  - `refreshToken` string — The refresh token

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.

---

[API](https://skmtc.dev/nexiopay/apis/payments-api-reference.md) · [All operations](https://skmtc.dev/nexiopay/apis/payments-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nexiopay/payments-api-reference/revisions/b414b73979e5/schema)