> For the complete documentation index, see [llms.txt](https://heytorus.gitbook.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://heytorus.gitbook.io/authentication/login.md).

# Login

## Login flow

The login flow starts when navigating to the Torus Digital login.

**Initiate Login Process**: navigate to the Torus Digital login page using the following URL, replacing \<API\_KEY> with your actual API key

<pre data-title="Base URL" data-overflow="wrap" data-full-width="false"><code><strong>https://connects.torusdigital.com/connect/login/&#x3C;API_KEY>
</strong></code></pre>

**Redirect to SSO Login**:  Upon accessing the API URL, the user is redirected to the SSO login page to authenticate

#### Email or Mobile Verification

The user verifies their identity through one of the following methods:

* **Email Verification:** An OTP (One-Time Password) is sent to the user's registered email.
* **Mobile Verification:** An OTP is sent to the user's registered mobile number.

#### OTP Validation

The user enters the received OTP on the verification page. If the OTP is valid, the user is redirected to the end URL.

#### Retrieve Request Token:

After successful OTP validation and redirection, you will receive a final URL that includes a REQUEST\_TOKEN

### Notes

* During the onboarding process, when you register as a client with us, you will receive your API key and API secret.
* Keep all URLs and tokens confidential and secure.
* Validate OTPs promptly as they are time-sensitive.
* Handle your token keys securely as they are essential for accessing the API.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://heytorus.gitbook.io/authentication/login.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.