# Come creo una chiave API per un’integrazione? In La mia azienda, apri API pubblica, crea una chiave con i permessi necessari e copiala: viene mostrata una sola volta. Apri in Kinmu: ## Sul web 1. ### Apri l’azienda Seleziona **La mia azienda**. Compare la configurazione aziendale. 2. ### Apri l’API In **Estensioni**, seleziona **API pubblica**. Si apre la scheda delle chiavi API. 3. ### Crea una chiave Seleziona **Crea chiave API**. Compare il modulo. 4. ### Assegna un nome Compila **Nome**. Se puoi scegliere l’ambiente, seleziona produzione o sandbox, che usa un’azienda di prova con dati sintetici. Nome e ambiente sono impostati. 5. ### Imposta la scadenza Scegli una durata oppure nessuna scadenza. Una chiave con scadenza smette automaticamente di funzionare alla data prevista. 6. ### Scegli i permessi Seleziona solo quelli necessari all’integrazione. I permessi scelti compaiono nel modulo. 7. ### Genera la chiave Seleziona **Crea chiave**. La chiave completa viene mostrata per l’unica volta. 8. ### Copia la chiave Copiala, conservala in un posto sicuro e seleziona **Fatto**. La chiave compare mascherata nell’elenco. ## Se non trovi l’opzione - Sul telefono, apri prima il menu con il pulsante del menu. - Servono l’estensione dell’API pubblica e il ruolo **Amministratore Globale** o **Manager**. - Se hai raggiunto il limite di chiavi attive, revocane una prima di crearne un’altra. Devi selezionare almeno un permesso. ## Domande frequenti ### Posso recuperare una chiave persa? No. Ruotala o creane una nuova. Dopo la rotazione, la vecchia smette subito di funzionare: aggiorna le integrazioni. ### Come blocco un’integrazione? Revoca la sua chiave. L’effetto è immediato e irreversibile. ## Risultato La chiave è pronta per l’integrazione, che la invia nell’header Authorization: Bearer. La documentazione tecnica è su [docs.kinmu.app](https://docs.kinmu.app/).