---
title: "Create guidance session"
method: POST
path: "/v3/guidance/guidance-sessions"
tags: ["Guidance"]
---

# Create guidance session

`POST /v3/guidance/guidance-sessions`

For eligible partners only. Create a reusable frontend session for the guidance experience.

## Request body

- object
  - `user_uuid` string, uuid, required — The UUID of the user for whom the guidance session is created
  - `country_code` string, required — The ISO 3166-1 alpha-2 country code (2 uppercase letters)
  - `company_identification_number` string, required — The identification number of the company (SIREN, ...) (9 digits)
  - `language` 'fr' | 'en' — Optional language used to generate guidance content. Defaults to fr when omitted.
  - `contact_email` string, email, nullable — Optional contact email address
  - `contact_phone_number` string, nullable — Optional contact phone number

## Response `200`

Guidance session created successfully

- object
  - `id` string, uuid, required — The created guidance session identifier
  - `url` string, required — The frontend URL for the guidance session
  - `password` string, required — The password the end user must provide to access the guidance session

## Other responses

- `400` — Invalid request body
- `401` — User not found
- `403` — IP whitelisting is too broad and must be restricted to specific IP addresses or /32 CIDR ranges

---

[API](https://skmtc.dev/bridgeapi/apis/bridge-api.md) · [All operations](https://skmtc.dev/bridgeapi/apis/bridge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bridgeapi/bridge-api/revisions/9b9ad8010fd5/schema)