Skip to content

Démarrage rapide ​

Envoyez votre premier email avec Mailiqo en quelques minutes.

1. Créer une clé API ​

Ouvrez votre tableau de bord et générez une nouvelle clé API.

Vous utiliserez cette clé pour authentifier toutes vos requêtes API.

bash
X-API-KEY: YOUR_API_KEY

2. Vérifier votre domaine ​

Avant d'envoyer des emails, vous devez vérifier votre domaine.

Ajoutez les enregistrements DNS requis (SPF et DKIM) chez votre fournisseur DNS. Ces enregistrements vous sont fournis dans le tableau de bord lors de la configuration de votre domaine.

Exemple :

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

⚠️ Vous devez terminer cette étape avant d'envoyer des emails en production.

➡️ Guide complet : /fr/help/domain-dns

3. Envoyer votre premier email ​

Faites une requête vers l'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": "Bonjour de Mailiqo",
    "body_html": "<p>Bonjour le monde</p>"
  }'

Réponse ​

json
{
  "uuid": "UUID",
  "sent_to": [{"email": "[email protected]"}],
  "rejected_recipients": []
}

Cela signifie que votre demande d'envoi a été acceptée et mise en file pour traitement.

4. Vérifier le statut de la requête ​

Vous pouvez consulter le statut de votre requête :

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

Exemple de réponse ​

json
{
  "email_request": {
    "uuid": "ecbc0597-4823-4c9c-9cbb-xxxxxxxx",
    "status": "QUEUED",
    "total_recipients": 1,
    "domain": "votredomaine.com",
    "from_email": "[email protected]",
    "subject": "Bonjour de 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. Récupérer les détails de l'email ​

Une fois traité, vous pouvez récupérer l'objet email final :

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

Exemple de réponse ​

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
}

Utiliser SMTP à la place ​

Si vous préférez SMTP, vous pouvez envoyer des emails sans passer par l'API.

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

➡️ Guide SMTP : /fr/smtp/overview


Étapes suivantes ​

Built with VitePress