Avvio rapido
Invia la tua prima email con Mailiqo in pochi minuti.
1. Crea un'API key
Accedi al pannello e genera una nuova API key.
La userai per autenticare tutte le richieste all'API.
X-API-KEY: YOUR_API_KEY2. Verifica il tuo dominio
Prima di inviare email devi verificare il tuo dominio.
Aggiungi i record DNS richiesti (SPF e DKIM) presso il tuo provider DNS. Il pannello te li mostra quando configuri il dominio.
Esempio:
Type: TXT
Name: @
Value: v=spf1 include:_spf.mmail.mailiqo.com ~allType: CNAME
Name: ***abc123._domainkey
Value: ***abc123._domainkey.mmail.mailiqo.com⚠️ Devi completare questo passaggio prima di inviare email in produzione.
➡️ Guida completa: /it/help/domain-dns
3. Invia la tua prima email
Fai una richiesta all'endpoint /send:
curl -X POST https://api.mailiqo.com/v1/mailing/send \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "[email protected]",
"to": ["[email protected]"],
"subject": "Ciao da Mailiqo",
"body_html": "<p>Ciao mondo</p>"
}'Risposta
{
"uuid": "UUID",
"sent_to": [{"email": "[email protected]"}],
"rejected_recipients": []
}Significa che la richiesta è stata accettata e messa in coda per l'elaborazione.
4. Controlla lo stato della richiesta
Puoi consultare lo stato della tua richiesta:
curl https://api.mailiqo.com/v1/mailing/email-request/{UUID} \
-H "X-API-KEY: YOUR_API_KEY"Esempio di risposta
{
"email_request": {
"uuid": "ecbc0597-4823-4c9c-9cbb-xxxxxxxx",
"status": "QUEUED",
"total_recipients": 1,
"domain": "tuodominio.com",
"from_email": "[email protected]",
"subject": "Ciao da Mailiqo",
"email_messages": [
"c82929b4-8c6e-45f0-b048-xxxxxxxx"
],
"total_attachments": 0,
"recipients": {
"to": [
{
"email": "[email protected]",
"name": ""
}
],
"cc": [],
"bcc": []
},
"created_at": {
"date": "2026-03-20 10:29:05.000000",
"timezone_type": 3,
"timezone": "UTC"
}
}
}5. Ottieni i dettagli dell'email
Una volta elaborata, puoi recuperare l'oggetto email finale:
curl https://api.mailiqo.com/v1/mailing/email-message/{UUID} \
-H "X-API-KEY: YOUR_API_KEY"Esempio di risposta
{
"uuid": "c82929b4-8c6e-45f0-b048-xxxxxxxxx",
"email_message_base_uuid": "ecbc0597-4823-4c9c-9cbb-xxxxxxxx",
"recipient_email": "[email protected]",
"recipient_type": "to",
"status": "delivered",
"created_at": "2026-01-01T10:29:06+00:00",
"submitted_at": "2026-01-01T10:29:06+00:00",
"opens_count": 1,
"clicks_count": 0
}Usare SMTP al posto dell'API
Se preferisci SMTP, puoi inviare email senza usare l'API.
Host: smtpmq.mailiqo.com
Port: 587
Encryption: TLS
Username: YOUR_SMTP_USER
Password: YOUR_SMTP_PASSWORD➡️ Guida SMTP: /it/smtp/overview
Prossimi passi
- Scopri di più sull'autenticazione → /it/api-reference/authentication
- Esplora tutti gli endpoint → /it/api-reference/post-send
- Configura il tuo dominio → /it/help/domain-dns
