DocumentazioneAPI key in Settings

API key in Settings

Creare, copiare e assegnare scope alle API key dal pannello.

Le API key si creano e revocano in Settings → API keys del dashboard. L'interfaccia avvolge lo stesso flusso POST /tenants/:id/api-keys documentato nella reference REST.

Creare una key

  1. Apri Settings

    Barra laterale → SettingsAPI keys

  2. Crea

    Clicca Create API key e inserisci un nome descrittivo (prod-nextjs, staging-crm)

  3. Seleziona scope

    Seleziona solo i permessi necessari all'integrazione. Vedi la tabella scope.

  4. Copia una volta

    La key completa (mc_live_... o mc_test_...) viene mostrata solo una volta. Salvala subito nel gestore segreti.

Selezione scope

ScopeConsente
email:sendInviare email, batch, programmati
email:readLog email, annullare programmati
contacts:read / contacts:writeAudience e cancellazione GDPR
campaigns:read / campaigns:writeCampagne newsletter
suppressions:read / suppressions:writeLista soppressione
webhooks:manageEndpoint webhook in uscita
sequences:read / sequences:writeSequenze automatiche (API)

Revocare e ruotare

Nella stessa schermata puoi revocare key inutilizzate. Per la rotazione:

  1. Crea una nuova key con gli stessi scope
  2. Aggiorna i segreti nel deploy
  3. Revoca la key vecchia

Vedi anche Sicurezza API key e API key e scope.