---
updatedAt: 2026-06-08T08:35:08.000Z
agentTools:
  projectIndex: https://docs.bridgeapi.io/llms.txt
---

# Create your first guidance session from the API

# Guidance sessions creation

When you create a guidance with the [Guidance session](https://docs.bridgeapi.io/reference/createguidancesession) endpoint, the required fields are:

* `user_uuid`: Identify the user for which the guidance should be accessible. The user\_uuid should be obtain after [creating a user](https://docs.bridgeapi.io/reference/createuser) and after [doing a user management session](https://docs.bridgeapi.io/reference/createusermanagementsession) or [doing a connect session](https://docs.bridgeapi.io/reference/createconnectsession).
* `country_code`: Specify the country of the company with the ISO 3166 (Alpha-2) format
* `company_identification_number`: Specify the identification number of the company (in France it’s the SIREN)

You can also define 3 additional and optional values that impact the user experience :

* `language`: Define the language in which the user will see the session. If not mention it will take his browsing language
* `contact_email`: Share the contact email of the user, we would be able to notify the user that a new guidance is ready.
* `contact_phone_number`: Share the contact phone number of the user, we would be able to notify the user that a new guidance is ready.

**Response**

```json
{
  "id": "a838cdb0-42a0-42fb-bcf7-2bd5dcdce163",
  "url": "https://guidance.bridgeapi.io/session/a838cdb0-42a0-42fb-bcf7-2bd5dcdce163",
  "password": "Ab3!Cd4@Ef5(Gh6)Ij7K"
}
```

We recommend to follow our security guidelines regarding the password here : XXXXXXXXX

# Userflow

1. **Step 1 - Secure access to guidance**
2. ![](https://files.readme.io/ed4d4fb24425129fec237777d5f07b21ea12f621d0dc54978f1d931533a19f1a-image.png)

   **Step 2 - User consent**

   ![](https://files.readme.io/59af444688c151d3f81e950afbe702b58bf298ac57d83f8714fcb292218d0d03-image.png)

*This step is only done once. If a company has given its consent, it will not be asked for consent again.*

3. **Step 3 - Guidance loader**

   ![](https://files.readme.io/8ddf44f78597bc3e32eab0cc60f566c623354086b210d5a6667026cc0939dd70-image.png)

*This step will only be shown when generating the first piece of guidance; afterward, the guidance will already be available in their interface.*

*⌚ The duration vary depending on the amount of transactions to take into considerations, from a few second to potentially an hour.*

4. **Step 4 - Guidance**

   ![](https://files.readme.io/ae6d4e2223612179162ddf4a501602ebc09ef62eab98857e12f88aca04338b1b-image.png)

ℹ️ The session has a duration of 8 hours. You can generate a new session before the end of the previous one. Do not store the session time has it might evolve on Bridge side for security reasons.