# Quick Start

Here you'll set up your environment to start playing with our API. If you don't know what our API is, you can refer to our [API overview](https://docs.powens.com/documentation/integration-guides/quick-start/api-overview).

{% hint style="info" %} <mark style="color:blue;">To smooth out the onboarding, along the way we notify how to be compliant with the PSD2.</mark>
{% endhint %}

### Create your account <a href="#create-your-account" id="create-your-account"></a>

[Sign up in our administration console](https://console.budget-insight.com/auth/register). You can then check your inbox, confirm your account and log in. **Congratulations! Welcome to our Console.**

### Register an organization or join one <a href="#register-an-organization-or-join-one" id="register-an-organization-or-join-one"></a>

Once logged in, you will have to fill a few information about your company to create your organization. Here is the information to be filled in:

* company name,
* company size,
* country,
* activity area.

*Your company name will be used as organization name and also to create your first workspace.*

### Register your domain <a href="#register-your-domain" id="register-your-domain"></a>

Once your organization and first workspace are created, click on the creation button (the large "**+**") and choose a domain name. The domain will be created as a "sandbox" configuration, and automatically suffixed with `-sandbox.biapi.pro`.

{% hint style="info" %} <mark style="color:blue;">Use your project name as your domain name to ease management. Avoid generic names like "test" to facilitate tickets management.</mark>
{% endhint %}

In the following sections, we'll use the term "your API" to refer to calls made to your domain.

### Register a client application <a href="#register-a-client-application" id="register-a-client-application"></a>

A client application identifies a caller requesting your API. You need at least one client.

The definition of a client application lets you configure the associated Webview, a ready-to-use web interface to add connections to your domain. You can configure multiple client applications if you wish to propose webviews with different settings.

From the administration console:

* select your domain and click on "Client Applications" on the left sidebar;
* in the upper-right corner, click on "Add a client" and fill the form;
* modify the logo, layout and primary colors;
* configure a redirect URL that is used by the webview after the connection flow;
* click on "Add a client". Your client should now appear in the list of client applications.

{% hint style="info" %} <mark style="color:blue;">You can define multiple redirect URLs for a single client application. You must use secure HTTPS protocol, or an app-specific scheme.</mark>
{% endhint %}

{% hint style="warning" %} <mark style="color:orange;">The created "Client ID" and "Client secret", represent your base credentials when querying the API or requesting the webview.</mark>
{% endhint %}

### Register a webhook <a href="#register-a-webhook" id="register-a-webhook"></a>

In addition to a REST API, we provide you with a [webhook mechanism](https://docs.powens.com/documentation/integration-guides/webhooks) that is the recommanded approach to be notified when new data is available in your API. You can declare a subscription to a webhook in the console and we will push the data to your server when the appropriate event occurs.

To add a webhook:

* click on "Webhooks" on the left sidebar;
* click on the button "Add a webhook" on the upper-righ corner;
* select an event and type your server URL.

### Integrate the API <a href="#integrate-the-api" id="integrate-the-api"></a>

Well done! Now that your domain is properly configured, you can use the API starting by [adding users and connections](https://docs.powens.com/documentation/integration-guides/quick-start/add-a-first-user-and-connection) or [initiating payments](https://docs.powens.com/documentation/integration-guides/broken-reference).

{% hint style="info" %} <mark style="color:blue;">For a trial or a quick demo you have the opportunity to easily test a connection with a fake connector "Connecteur de test", available in all domains. Use any username and the password "1234" to log in.</mark>
{% 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.powens.com/documentation/integration-guides/quick-start.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.