Skip to content

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.

bash
X-API-KEY: YOUR_API_KEY

2. 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:

txt
Type: TXT
Name: @
Value: v=spf1 include:_spf.mmail.mailiqo.com ~all
txt
Type: 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:

bash
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 ​

json
{
  "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:

bash
curl https://api.mailiqo.com/v1/mailing/email-request/{UUID} \
  -H "X-API-KEY: YOUR_API_KEY"

Esempio di risposta ​

json
{
  "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:

bash
curl https://api.mailiqo.com/v1/mailing/email-message/{UUID} \
  -H "X-API-KEY: YOUR_API_KEY"

Esempio di risposta ​

json
{
  "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.

txt
Host: smtpmq.mailiqo.com
Port: 587
Encryption: TLS
Username: YOUR_SMTP_USER
Password: YOUR_SMTP_PASSWORD

➡️ Guida SMTP: /it/smtp/overview


Prossimi passi ​

Built with VitePress