Aggiunge una casella di posta a un dominio.
POSThttps://console.icbs.it/api/v1/email/{dominio}/accounts| Parametro | Posizione | Obbligatorio | Descrizione |
|---|---|---|---|
dominio | indirizzo | sì | Il nome a dominio, per esempio esempio.it. |
address | corpo | sì | Solo la parte prima della chiocciola: info, non info@esempio.it. |
name | corpo | sì | Il nome che vedi nell'elenco delle caselle. |
password | corpo | sì | Almeno 8 caratteri. |
quotaBytes | corpo | no | Spazio assegnato. Se omesso vale quello previsto dal tuo piano. |
active | corpo | no | Se omesso la casella nasce attiva. |
protocols | corpo | no | Quali protocolli abilitare: {"imap": true, "pop3": false, "smtp": true}. |
copyTo | corpo | no | Indirizzo a cui inviare una copia dei messaggi in arrivo. |
note | corpo | no | Una nota interna sulla casella. |
curl -X POST -H "Authorization: Bearer $ICBS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"address":"info","name":"Informazioni","password":"unaPasswordSolida","quotaBytes":5368709120}' \
https://console.icbs.it/api/v1/email/esempio.it/accounts
{
"id": 318,
"address": "info@esempio.it",
"name": "Informazioni",
"active": true,
"quotaBytes": 5368709120,
"protocols": { "imap": true, "pop3": true, "smtp": true }
}
Annota l'id: serve per modificare o eliminare la casella.
La risposta non contiene la password. Se la perdi non si recupera: se ne imposta una nuova con Modificare una casella.
Ogni dominio ha un numero massimo di caselle, quello del tuo piano: lo trovi in accountsMax di Elenco dei domini. Raggiunto il limite, la creazione viene rifiutata.
| Codice | Causa |
|---|---|
400 | Indirizzo, nome, password o quota non validi. |
401 | Chiave assente, non valida, scaduta o revocata. |
403 | Alla chiave manca il permesso Email — scrittura. |
404 | Il dominio non è nel tuo account o non è visibile a questa chiave. |
409 | Esiste già una casella con quell'indirizzo, oppure il dominio è protetto da modifiche o non attivo. |
429 | Superato il limite di richieste. |