# How it works

Verida AI allows users to easily and quickly connect their private data from other applications into your application or AI product. Once integrated, your AI application can access a user's Gmail, Calendar, Drive, Telegram and much more.

<figure><img src="/files/WOyBCkf72MQa1fYnh7IN" alt=""><figcaption><p>The steps for users to connect their data to your application</p></figcaption></figure>

## User Account Creation

Your user creates an account in the [Verida Vault](/resources/verida-vault.md) (<https://app.verida.ai/>) that manages all their private data and application connections.

<figure><img src="/files/3sJZGGNSEk45JqqUnKhv" alt=""><figcaption><p>Getting started screen from the Verida Vault (https://app.verida.ai/)</p></figcaption></figure>

If a user doesn't have an account, they will be prompted to create one when they connect to your application.

## Data Synchronization

Once a user has a Verida Vault account, they can connect to existing third party platforms they use (ie: Google, Telegram, Discord etc.). The Verida Vault will then start syncronizing the user's data in the background. This data is encrypted with private keys owned by the user and stored on the Verida Network.

## API Connection

This works very similar to "Connect Google" or "Connect Facebook" buttons, enabling a user to authorize your application to access their data.

<figure><img src="/files/tH62KenVCoaydu4gPgjo" alt=""><figcaption></figcaption></figure>

A user clicks a "Connect Verida" button in your application (see [Authentication](/getting-started/authentication.md) and [Developer Console](/getting-started/developer-console.md)) and is redirected to the Verida Vault and is presented with a screen allowing them to allow your application to access their data.

<figure><img src="/files/fIVf5AKeP35Q7GmNmbSt" alt=""><figcaption></figcaption></figure>

## Application Interaction

Once the user has allowed access, they will be redirected to your application and an API auth token will be included in the URL query parameters.

This API auth token can then be used:

1. For a [PersonalAgentKit](/integrations/personalagentkit.md) integration such as [LangGraph](/integrations/langgraph.md).
2. To make direct API requests using the [Data APIs](/data-apis/overview.md).

{% hint style="success" %}
Test this complete flow using the [Developer Console](/getting-started/developer-console.md)
{% endhint %}


---

# 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://docs.verida.ai/getting-started/how-it-works.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.