Creare un inoltro

Crea un indirizzo che non conserva la posta ma la recapita altrove.

• Metodo: POST
• Indirizzo: https://console.icbs.it/api/v1/email/{dominio}/forwards
• Permesso: Email — scrittura

Parametri

Parametro	Posizione	Obbligatorio	Descrizione
dominio	indirizzo	sì	Il nome a dominio, per esempio esempio.it.
source	corpo	sì	Solo la parte prima della chiocciola: ordini, non ordini@esempio.it.
destinations	corpo	sì	Gli indirizzi a cui recapitare la posta, fino a 10.
active	corpo	no	Se omesso l'inoltro nasce attivo.
allowSendAs	corpo	no	Se il destinatario può anche inviare posta usando l'indirizzo di partenza.

Esempio di richiesta

curl -X POST -H "Authorization: Bearer $ICBS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"ordini","destinations":["amministrazione@altro-dominio.it"]}' \
  https://console.icbs.it/api/v1/email/esempio.it/forwards

Esempio di risposta

{
  "id": 88,
  "source": "ordini@esempio.it",
  "destinations": ["amministrazione@altro-dominio.it"],
  "active": true,
  "allowSendAs": false
}

Un indirizzo o riceve, o inoltra

Non puoi creare un inoltro con lo stesso indirizzo di una casella esistente, né due inoltri con la stessa partenza. Se ordini@esempio.it è già una casella, la posta è già a destinazione: per mandarne una copia altrove usa copyTo in Modificare una casella.

Più destinatari

Indicandone più di uno, ogni messaggio viene recapitato a tutti. Il limite è di 10 destinatari per inoltro.

Possibili errori

Codice	Causa
400	Indirizzo di partenza non valido, destinatari mancanti, non validi o troppi.
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	L'indirizzo di partenza è già usato, oppure il dominio è protetto da modifiche o non attivo.
429	Superato il limite di richieste.