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

# Connecter Superhote V2

> Relier votre compte Superhote à Firby avec une clé API.

Superhote V2 se connecte avec une **clé API** créée depuis votre compte Superhote.
Contrairement à la [connexion Superhote classique](/pms/superhote), vous n'avez pas à
partager votre mot de passe : la clé donne uniquement les accès que vous choisissez.

## Créer la clé API dans Superhote

1. Dans Superhote, ouvrez **Plateformes et Intégrations → API**.
2. Cliquez sur **Créer une clé API**.

<img src="https://mintcdn.com/firby/mx5oDTfnYvIlTYPH/images/superhote-cle-api.png?fit=max&auto=format&n=mx5oDTfnYvIlTYPH&q=85&s=53793f4b9600e7540a1ede0f8c79f96b" alt="Superhote : Plateformes et Intégrations → API → Créer une clé API" className="w-full rounded-xl" width="2538" height="1210" data-path="images/superhote-cle-api.png" />

3. Donnez un nom à la clé, par exemple **Firby**.
4. Cochez **Lecture des hébergements** et **Lecture des réservations**. Les autres
   permissions ne sont pas nécessaires : Firby lit vos données, il ne les modifie
   jamais.
5. Choisissez une **expiration**, puis cliquez sur **Créer la clé API**.
6. Copiez la clé affichée — elle n'est montrée qu'une fois.

<img src="https://mintcdn.com/firby/6c--BAnpv1Q05hbh/images/superhote-v2-nouvelle-cle.png?fit=max&auto=format&n=6c--BAnpv1Q05hbh&q=85&s=46a150a0492f75ae65c1f5b2866249e6" alt="Superhote : fenêtre Nouvelle clé API avec le nom Firby et les permissions de lecture cochées" className="mx-auto rounded-xl" style={{ maxWidth: '420px' }} width="594" height="1055" data-path="images/superhote-v2-nouvelle-cle.png" />

## Connecter dans Firby

1. Ouvrez **Connexions → PMS** et choisissez **Superhote V2**.
2. Collez votre clé dans le champ **Token API Superhote**.
3. Validez : Firby vérifie la connexion et importe vos logements.

<Tip>
  Après la première connexion, lancez une **synchronisation manuelle** pour vérifier que
  vos logements et réservations remontent comme attendu. Voir
  [La synchronisation, en bref](/pms/synchronisation).
</Tip>

<Note>
  Superhote V2 ne transmet pas les propriétaires : créez-les dans Firby et rattachez-les
  à leurs logements. Voir [Gérer vos propriétaires](/proprietaires/gestion).
</Note>

<Note>
  La clé expire au terme de la durée choisie à sa création. Passé ce délai, la
  synchronisation s'arrête : recréez une clé dans Superhote et mettez-la à jour dans
  **Connexions → PMS**.
</Note>