# Step 1 - User Account Creation

In this step, the Client will be able to create an account with a login and verify the ownership of the information (telephone number) he has provided through OTP. 

1 - As on any other application, the Client will have to create an account. 

{% openapi src="/files/CxdhNANltvpAtSQ3ieEA" path="/v1/user/sign-up" method="post" %}
[stokn\_api.json](https://4184423511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50DZdVHQuJqLLMFS5pFA%2Fuploads%2FtArCzZFBOjwtLNo3PlL8%2Fstokn_api.json?alt=media\&token=f6fefe86-fbfd-49de-9419-503e5c449364)
{% endopenapi %}

OAuth: client\_auth

2 - The client will then be able to login using his e-mail and password: 

## Client can login to the application 

<mark style="color:green;">`POST`</mark>&#x20;

#### Path Parameters

| Name                                          | Type     | Description                                            |
| --------------------------------------------- | -------- | ------------------------------------------------------ |
| "username":<mark style="color:red;">\*</mark> | "string" | Client ads his username                                |
| "password"<mark style="color:red;">\*</mark>  | "string" | Client ads the password he chose in the previous step. |

{% tabs %}
{% tab title="200: OK " %}

```json
{
  "success": true,
  "data": {},
  "errorCode": 0,
  "errorMessage": "string"
}
```

{% endtab %}
{% endtabs %}

OAuth: client\_auth

3 - The client then need to respond to an OTP challenge, i.e he will receive a text message which includes a 4 digit number that he will need to pasted into the Mobile App:&#x20;

{% openapi src="/files/CxdhNANltvpAtSQ3ieEA" path="/v1/user/otp" method="post" %}
[stokn\_api.json](https://4184423511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50DZdVHQuJqLLMFS5pFA%2Fuploads%2FtArCzZFBOjwtLNo3PlL8%2Fstokn_api.json?alt=media\&token=f6fefe86-fbfd-49de-9419-503e5c449364)
{% endopenapi %}

Responding to the OTP challenge correctly, will allow the user to receive an access token to access features (deposit, withdraw, convert).

OAuth: user\_auth

If this is not the case, it will be possible to refresh the OPT token using:&#x20;

{% openapi src="/files/CxdhNANltvpAtSQ3ieEA" path="/v1/user/refresh" method="post" %}
[stokn\_api.json](https://4184423511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50DZdVHQuJqLLMFS5pFA%2Fuploads%2FtArCzZFBOjwtLNo3PlL8%2Fstokn_api.json?alt=media\&token=f6fefe86-fbfd-49de-9419-503e5c449364)
{% endopenapi %}

4 - If the User loses his password, it is possible to generate a new one using:&#x20;

{% openapi src="/files/CxdhNANltvpAtSQ3ieEA" path="/v1/user/change-password" method="put" %}
[stokn\_api.json](https://4184423511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50DZdVHQuJqLLMFS5pFA%2Fuploads%2FtArCzZFBOjwtLNo3PlL8%2Fstokn_api.json?alt=media\&token=f6fefe86-fbfd-49de-9419-503e5c449364)
{% endopenapi %}

To validate the change of the password, the User will receive a new OTP challenge in the form as describe in point 3 above.&#x20;

You can add this OTP challenge using:&#x20;

{% openapi src="/files/CxdhNANltvpAtSQ3ieEA" path="/v1/user/forget-password" method="get" %}
[stokn\_api.json](https://4184423511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50DZdVHQuJqLLMFS5pFA%2Fuploads%2FtArCzZFBOjwtLNo3PlL8%2Fstokn_api.json?alt=media\&token=f6fefe86-fbfd-49de-9419-503e5c449364)
{% endopenapi %}

5 - Once the KYC process as been completed and validated for a retail client ([as described in step 2 below](/welcome-to-stokn.io/step-2-user-kyc.md)), the account will be validated and it will be possible to generate a Portfolio Id using:&#x20;

{% openapi src="/files/CxdhNANltvpAtSQ3ieEA" path="/v1/account/portfolio" method="post" %}
[stokn\_api.json](https://4184423511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50DZdVHQuJqLLMFS5pFA%2Fuploads%2FtArCzZFBOjwtLNo3PlL8%2Fstokn_api.json?alt=media\&token=f6fefe86-fbfd-49de-9419-503e5c449364)
{% endopenapi %}

OAuth: client\_auth

A portfolio Id is linked to a blockchain public address and several Portfolio Id can be generated for a same Account Id. <br>

6 - Please note that you will also be able to create manually an **AccountId** using:&#x20;

{% openapi src="/files/CxdhNANltvpAtSQ3ieEA" path="/v1/account" method="post" %}
[stokn\_api.json](https://4184423511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F50DZdVHQuJqLLMFS5pFA%2Fuploads%2FtArCzZFBOjwtLNo3PlL8%2Fstokn_api.json?alt=media\&token=f6fefe86-fbfd-49de-9419-503e5c449364)
{% endopenapi %}

OAuth: client\_auth

The PortfolioId will only be generated once the User has completed the KYC process ([as described in Step 2](/welcome-to-stokn.io/step-2-user-kyc.md)).&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stokn.gitbook.io/welcome-to-stokn.io/step-1-user-account-creation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.