Creare un gruppo

Aggiunge un nuovo gruppo al tuo account.

• Metodo: POST
• Indirizzo: https://console.icbs.it/api/v1/groups
• Permesso: Gruppi — creazione, modifica ed eliminazione

Parametri

I parametri vanno nel corpo della richiesta in formato JSON.

Parametro	Posizione	Obbligatorio	Descrizione
name	corpo	sì	Nome del gruppo.
comment	corpo	no	Descrizione libera.
type	corpo	no	Tipo di gruppo. Se omesso vale il tipo predefinito.

Esempio di richiesta

curl -X POST \
  -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Clienti 2026","comment":"Nuove attivazioni"}' \
  https://console.icbs.it/api/v1/groups

Esempio di risposta

{
  "created": {
    "name": "Clienti 2026",
    "type": "domain"
  }
}

La risposta non contiene l'id del nuovo gruppo: per ottenerlo richiama l'elenco dei gruppi.

Possibili errori

Codice	Causa
400	Nome mancante o dati non validi.
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso di scrittura sui gruppi, oppure chi l'ha creata non ha più i permessi di modifica.
429	Superato il limite di richieste. Le scritture hanno un tetto orario più basso delle letture.