> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ownid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Started

> Start here to build a user journey with the SDK

## Integration Overview

Three primary steps are required to implement OwnID journeys end-to-end.

<Steps>
  <Step title="Preparation">
    [Set up your account](https://console.ownid.com/login), get your application id, and add a field to your user table to store OwnID data.
  </Step>

  <Step title="Backend - Build Server-Side Endpoints">
    Add the three event handlers that manage requests to each of three end-points made by the OwnID server when it receives login events from your frontend.
  </Step>

  <Step title="Frontend - Build User Journeys">
    Add our HTML JavaScript, templates, and the OwnID Password widget to build the login, registration, account recovery  workflow and install the OwnID Password widget.
  </Step>
</Steps>

***

## Preparation

Before starting, create your account in the [OwnID Admin Console](https://console.ownid.com/login), register your base URL, and get your application id.

<img width="500" src="https://mintcdn.com/ownid/vB8sMNDo6U3bB1sG/images/open_account.png?fit=max&auto=format&n=vB8sMNDo6U3bB1sG&q=85&s=9d9959ab6ea9512a35a2cf920e098bb8" alt="Open Account in Console" data-path="images/open_account.png" />

1. **Create your App**\
   Login to the OwnID Admin Console and follow the instructions to create an app. You will also be asked to define the `base URL` that OwnID will use to make requests to your web server.  The console guides you through this process step by step.

<img width="500" src="https://mintcdn.com/ownid/-VBqqlNX4RpmYITg/images/create_app.png?fit=max&auto=format&n=-VBqqlNX4RpmYITg&q=85&s=9cb6ab8eface18a9b8b830084cee0b94" alt="Create application in Console" data-path="images/create_app.png" />

<img width="500" src="https://mintcdn.com/ownid/-VBqqlNX4RpmYITg/images/get_details_from_app.png?fit=max&auto=format&n=-VBqqlNX4RpmYITg&q=85&s=7d271217a77e8f7289f2fa674532ea94" alt="Get application Details from Console" data-path="images/get_details_from_app.png" />

<Info> If you want to start with local development, you can create a tunnel to your localhost server using a tool like [ngrok](https://ngrok.com/download). For example: `https://84c5df474.ngrok-free.dev/api/ownid` </Info>

2. **Get Integration Credentials**\
   On your app page in the console, copy the following parameters needed for integration:

<Info>
  * Your **application id** - *Use this also in data objects where specified by the* `appId` *field.*
  * Your **shared secret** - *Use this to verify the signature in OwnID requests to your web server.*
</Info>

<img width="500" src="https://mintcdn.com/ownid/-VBqqlNX4RpmYITg/images/app_details.png?fit=max&auto=format&n=-VBqqlNX4RpmYITg&q=85&s=77dc0078b0575d1d1604d082e7e8c42f" alt="App Details from Console" data-path="images/app_details.png" />

3. **Create a VARCHAR field**\
   Create a new character field called `ownIdData` in your user database. We'll use this field to store OwnID authentication data for registered users.

<Info>
  Be sure the `ownIdData` field meets the following requirements:

  * A character datatype e.g., **VARCHAR**
  * A minimum length of **5000 chars**
</Info>

***

## Next Step

Before building frontend user journeys, you must add three request handlers to your web server.

<Card title="Build Server-Side Endpoints" icon="screwdriver-wrench" href="/building-blocks/build-server-endpoints">
  OwnID provides templates for the three request handlers you'll host on your web server. These form the endpoints called from the OwnID platform.
</Card>
