API v1.0

Documentation API

Apprenez à envoyer des emails illimités avec l'API MailShipper en quelques minutes.

1

Authentification

Toutes les requêtes doivent inclure votre API key dans les paramètres de requête.

?apikey={{ exampleApiKey }}

Important

Le domaine de votre senderEmail doit être autorisé par votre abonnement.

2

Envoyer un Email

Endpoint

POST {{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}

Paramètres du corps

Champ Type Requis Description
senderName string oui Nom de l'expéditeur
receiverEmail string oui Email du destinataire
subject string oui Sujet de l'email
body string oui Contenu HTML de l'email
senderEmail string oui Email d'envoi (doit utiliser un domaine autorisé)
password string oui Mot de passe du compte email
host string oui Serveur SMTP (ex: mail.votre-domaine.com)

Exemple de requête

{
  "senderName": "MailShipper",
  "receiverEmail": "client@example.com",
  "subject": "Bienvenue sur notre plateforme",
  "body": "<h1>Bonjour!</h1><p>Merci de vous inscrire.</p>",
  "senderEmail": "contact@votre-domaine.com",
  "password": "votre_mot_de_passe",
  "host": "mail.votre-domaine.com"
}

Exemples de code

curl -X POST '{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}' \
  -H "Content-Type: application/json" \
  -d '{
    "senderName": "MailShipper",
    "receiverEmail": "client@example.com",
    "subject": "Bienvenue",
    "body": "<h1>Bonjour!</h1>",
    "senderEmail": "contact@votre-domaine.com",
    "password": "votre_mot_de_passe",
    "host": "mail.votre-domaine.com"
  }'
const response = await fetch(
  '{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}',
  {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      senderName: 'MailShipper',
      receiverEmail: 'client@example.com',
      subject: 'Bienvenue',
      body: '<h1>Bonjour!</h1>',
      senderEmail: 'contact@votre-domaine.com',
      password: 'votre_mot_de_passe',
      host: 'mail.votre-domaine.com'
    })
  }
);

const data = await response.json();
console.log(data);
import requests

response = requests.post(
    '{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource',
    params={'apikey': '{{ exampleApiKey }}'},
    json={
        'senderName': 'MailShipper',
        'receiverEmail': 'client@example.com',
        'subject': 'Bienvenue',
        'body': '<h1>Bonjour!</h1>',
        'senderEmail': 'contact@votre-domaine.com',
        'password': 'votre_mot_de_passe',
        'host': 'mail.votre-domaine.com'
    }
)

print(response.json())
$response = curl_post(
  '{{ apiUrl }}/proxy/email/sendHtmlEmailWithCustomSource?apikey={{ exampleApiKey }}',
  [
    'senderName' => 'MailShipper',
    'receiverEmail' => 'client@example.com',
    'subject' => 'Bienvenue',
    'body' => '<h1>Bonjour!</h1>',
    'senderEmail' => 'contact@votre-domaine.com',
    'password' => 'votre_mot_de_passe',
    'host' => 'mail.votre-domaine.com'
  ]
);

$result = json_decode($response, true);
print_r($result);
3

Réponses

200

Succès

{
  "status": 200,
  "message": "sent",
  "data": {
    "accepted": ["client@example.com"],
    "rejected": [],
    "messageId": "<uuid@domaine.com>",
    "response": "250 OK id=..."
  }
}
401

API key invalide

{
  "success": false,
  "error": "API key invalide ou expirée"
}
403

Domaine non autorisé

{
  "success": false,
  "error": "Domaine exemple.com n'est pas autorisé. Domaines autorisés: votre-domaine.com"
}
4

Bonnes Pratiques

Vérifiez votre configuration SMTP

Assurez-vous que host, senderEmail et password sont corrects.

Domaine autorisé requis

Vérifiez votre dashboard pour voir les domaines inclus dans votre plan.

Sécurisez vos emails

Utilisez des mots de passe forts et activez l'authentification 2FA.

Envois illimités

Envoyez autant d'emails que vous voulez, aucune limite de volume.

5

Obtenir vos identifiants SMTP

Pour utiliser l'API, vous avez besoin de 3 informations SMTP :

  • Host : le serveur SMTP (ex: mail.votre-domaine.com)
  • Password : le mot de passe de votre compte email
  • Sender Email : votre adresse email complète

Guides par hébergeur

🔧

Namecheap

Email hosting cPanel

Créez un email via cPanel et récupérez vos identifiants SMTP.

Voir le guide
🔧

GoDaddy

Workspace Email

Configurez votre email professionnel et obtenez les accès SMTP.

Voir le guide
🔧

OVH / Hostinger

Hébergement web

Créez un compte email depuis votre panel d'hébergement.

Voir le guide

Google Workspace

Gmail professionnel

Utilisez Gmail avec le mot de passe d'application pour SMTP.

Voir le guide
🔧

Ionos / 1and1

Email Hosting

Créez des adresses email depuis votre panel Ionos.

Voir le guide
🔧

HostGator

cPanel Hosting

Accédez à vos identifiants SMTP via cPanel ou WHM.

Voir le guide

Autre fournisseur ?

Guide généraliste

Vous ne trouvez pas votre hébergeur ? Consultez notre guide général pour comprendre comment récupérer vos identifiants SMTP.

Voir le guide général

Configuration SMTP typique

Host mail.votre-domaine.com
Port 587 (TLS) ou 465 (SSL)
Username contact@votre-domaine.com
Password Votre mot de passe email

Prêt à envoyer des emails ?

Créez votre compte et commencez à utiliser l'API maintenant

Commencer maintenant