Le API di OnionMail sono raggiungibili attraverso la control port.
Si tratta di un server che usa un protocollo simile a POP3 pensato per poter essere utilizzato via telnet su localhost.
Solitamente l'indirizzo è 127.0.0.1 alla porta 19100. Questi parametri possono cambiare in base alla configurazione.
É anche possibile configurare delle control port pubbliche, le quali consentono l'accesso solo ad un server e sono con collegamento SSL.
Per aggiungere le porte pubbliche occorre modificare il file di configurazione servers.conf ed aggiungere nella descrizione del server i seguenti parametri:

PublicControlPort  9100

PublicControlIP    127.0.0.1

Il collegamenteo verso l'utente deve essere fatto tramite l'hidden service. Quindi occorrerà modificare di conseguenza torrc.

Quindi per eccedere tipicamente si usa telnet

telnet 127.0.0.1 9100

Le risposte del server iniziano sempre con +OK in caso di operazioni corrette. In caso di errori la risposta iniza sempre con -ERR.
A seguito c'è un messaggio oppure un risultato.
Per i comandi che implicano più righe l'ultima riga termina sempre con un punto.
Questo vale sia per il client che per il server.

Prima di tutto l'autenticazione

OnionMail utilizza un'autenticazione a cipolla, ovvero per accedere bisonga fare diverse autenticazioni fino ad arrivare al comando desiderato.
Il livelli sono diversi ed ogniuno ha una lettera (flag) che lo identifica.
Flags:

• K = Livello logon (Accesso di un utente amministratore di qualcosa)
• E = Utente identificato da una password.
• S = Utente SysOp su un server di posta.
• I = Utente identificato da un login.
• M = Utente identificato da un indirizzo mail.
• A = Accesso in corso ad un server di posta preciso.
• R = Utende di tipo ROOT

Accessi a cipolla:

• Accesso ad una mailing list come semplice utente
• Accesso ad una mailing list come utente amministratore.
• Accesso ad una mailing list come ROOT.
  
  Oppure:
• Accesso ad un server come semplice utente:
  user
  
  
• Accesso ad un server come SysOp.
  server
  Le password sono nei file di configurazione e possono essere cifrate.
  
  
• Accesso ROOT.
  su
  oppure:
  sux
  

Con il comando access si vede il tipo di accesso.

Accesso alla mailing list come utente

Si accede con il comando LIST
La Password-lista è assegnata durante l'iscrizione del utente ed il tipo di accesso dipende dal tipo di utente.

Nella lista i comandi disponibili sono:

• unsubscribe (Cancellazione dalla lista)
• passwd (Cambio password)
• getrulez (Ricevi il file RULEZ)

Per gli utenti amministratori:

• mode admin (Rende amministratore un utente)
• mode normal (Rende un utente normale)
• invite (invita un utente nella lista)
• remove (rimuove un utente dalla lista)
• list (Visualizza la lista delgi utenti)
• setrulez (imposta il file rulez, si procede come per l'invio di un messaggio SMTP)
• delete (Distrugge la lista)
• par (Cambia i parametri della lista)
  

Comandi sempre disponibili

• quit (Chiude la sessione)
• exit (Esce dall'autenticazione)
• access (Visualizza il tipo di accesso)
• elist (Lista dei nodi di uscita)
  

Accesso al server come user

Si accede con il comando user
Quindi i comandi disponibili sono:

• info (da informazioni sul server)
• sslcert (visualizza i dati del certificato SSL)
• par (Modifica i parametri e scegli il nodo di uscita)
• stat (Statistiche server)
  

Accesso al server come SysOp (KESIA)

Si accede con il comando server
Quindi i comandi disponibili di questo livello sono:

• list (Gestione Mailing List)
• spam (Gestione lista nera del server)
• mklist (Creazione mailing list)
• addusr (Creazione utenti)
• addpgpusr (Crea un utente usando i dati crittati con PGP)
  
• stat (Statistiche server)
  

Accesso al server come root (KERSIA)

Si accede con il comando su dopo il comando server.
Quindi i comandi disponibili sono:

• log (Invia un messaggio di log).
• stop now (Frema OnionMail immediatamente).
• stop session (Ferma una sessione della control Port).
• all (Visualizza tutte le sessioni della control port).