Ejemplos de código
Ejemplos para enviar a través de Mailiqo desde los lenguajes y frameworks más habituales, por SMTP o con la API.
Versiones consultadas el 2 de noviembre de 2026
Nodemailer 10.3.1, PHPMailer 7.1.1, Laravel 13 (válido también para 11 y 12), Symfony 8.1 y la biblioteca estándar de Python 3. Basado en la documentación oficial de cada proyecto (enlaces al final).
Antes de empezar
- SMTP: host
smtpmq.mailiqo.com, puerto587con STARTTLS (o465con TLS implícito), y el usuario y la contraseña SMTP del dominio, desde Email → Dominios. - API: una API key de Configuración → API e integraciones, enviada en la cabecera
X-API-KEY. Ver Autenticación. - El remitente debe ser una dirección del dominio verificado.
- No pongas las credenciales en el código. Los ejemplos las leen de las variables de entorno
MAILIQO_SMTP_USER,MAILIQO_SMTP_PASSyMAILIQO_API_KEY.
SMTP es la forma más rápida de conectar una aplicación que ya envía correo. La API devuelve el resultado por destinatario y un uuid para seguir la entrega. Ver SMTP Overview y API de envío de emails.
SMTP
Node.js (Nodemailer)
npm install nodemailerimport nodemailer from 'nodemailer';
const transporter = nodemailer.createTransport({
host: 'smtpmq.mailiqo.com',
port: 587,
secure: false,
requireTLS: true,
auth: {
user: process.env.MAILIQO_SMTP_USER,
pass: process.env.MAILIQO_SMTP_PASS,
},
});
const info = await transporter.sendMail({
from: '"Tu Tienda" <[email protected]>',
to: '[email protected]',
subject: 'Tu pedido ya ha salido',
text: 'Tu pedido está en camino.',
html: '<p>Tu pedido está en camino.</p>',
});
console.log(info.messageId);secure: false con requireTLS: true hace que Nodemailer cifre la conexión con STARTTLS y falle si no puede. Para el puerto 465, usa port: 465 y secure: true.
PHP (PHPMailer)
composer require phpmailer/phpmailer<?php
use PHPMailer\PHPMailer\Exception;
use PHPMailer\PHPMailer\PHPMailer;
require 'vendor/autoload.php';
$mail = new PHPMailer(true);
try {
$mail->isSMTP();
$mail->Host = 'smtpmq.mailiqo.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = getenv('MAILIQO_SMTP_USER');
$mail->Password = getenv('MAILIQO_SMTP_PASS');
$mail->CharSet = PHPMailer::CHARSET_UTF8;
$mail->setFrom('[email protected]', 'Tu Tienda');
$mail->addAddress('[email protected]');
$mail->isHTML(true);
$mail->Subject = 'Tu pedido ya ha salido';
$mail->Body = '<p>Tu pedido está en camino.</p>';
$mail->AltBody = 'Tu pedido está en camino.';
$mail->send();
} catch (Exception $e) {
echo $mail->ErrorInfo;
}Para el puerto 465, usa $mail->Port = 465 y PHPMailer::ENCRYPTION_SMTPS.
Laravel
En .env:
MAIL_MAILER=smtp
MAIL_SCHEME=smtp
MAIL_HOST=smtpmq.mailiqo.com
MAIL_PORT=587
MAIL_USERNAME=tu-usuario-smtp
MAIL_PASSWORD=tu-password-smtp
MAIL_FROM_ADDRESS[email protected]
MAIL_FROM_NAME="Tu Tienda"Con MAIL_SCHEME=smtp y el puerto 587, Laravel cifra la conexión con STARTTLS. Para el puerto 465, usa MAIL_PORT=465 y MAIL_SCHEME=smtps. En Laravel 10, usa MAIL_ENCRYPTION=tls en lugar de MAIL_SCHEME.
use Illuminate\Support\Facades\Mail;
Mail::raw('Tu pedido está en camino.', function ($message) {
$message->to('[email protected]')->subject('Tu pedido ya ha salido');
});En una aplicación real lo normal es enviar un Mailable; la configuración SMTP es la misma. Si la configuración está en caché, ejecuta php artisan config:cache después de cambiar .env.
Symfony Mailer
composer require symfony/mailerEn .env.local:
MAILER_DSN=smtp://USUARIO:[email protected]:587?require_tls=trueSi el usuario o la contraseña tienen caracteres especiales, codifícalos para URL. Para el puerto 465, usa smtps://USUARIO:[email protected]:465.
use Symfony\Component\Mailer\MailerInterface;
use Symfony\Component\Mime\Email;
final class OrderMailer
{
public function __construct(private MailerInterface $mailer)
{
}
public function sendShipped(string $to): void
{
$email = (new Email())
->from('[email protected]')
->to($to)
->subject('Tu pedido ya ha salido')
->text('Tu pedido está en camino.')
->html('<p>Tu pedido está en camino.</p>');
$this->mailer->send($email);
}
}Si tu aplicación usa Messenger, Symfony encola el correo por defecto y lo envía el worker, así que los errores SMTP aparecen en el worker.
Python (smtplib)
import os
import smtplib
import ssl
from email.message import EmailMessage
msg = EmailMessage()
msg['From'] = 'Tu Tienda <[email protected]>'
msg['To'] = '[email protected]'
msg['Subject'] = 'Tu pedido ya ha salido'
msg.set_content('Tu pedido está en camino.')
msg.add_alternative('<p>Tu pedido está en camino.</p>', subtype='html')
context = ssl.create_default_context()
with smtplib.SMTP('smtpmq.mailiqo.com', 587, timeout=30) as server:
server.starttls(context=context)
server.login(os.environ['MAILIQO_SMTP_USER'], os.environ['MAILIQO_SMTP_PASS'])
server.send_message(msg)Para el puerto 465, usa smtplib.SMTP_SSL('smtpmq.mailiqo.com', 465, context=context) y quita la llamada a starttls().
API
POST https://api.mailiqo.com/v1/mailing/send con el correo en JSON. Todos los campos están en POST /mailing/send.
curl -X POST https://api.mailiqo.com/v1/mailing/send \
-H "X-API-KEY: $MAILIQO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "[email protected]",
"to": "[email protected]",
"subject": "Tu pedido ya ha salido",
"body_html": "<p>Tu pedido está en camino.</p>",
"body_txt": "Tu pedido está en camino."
}'const response = await fetch('https://api.mailiqo.com/v1/mailing/send', {
method: 'POST',
headers: {
'X-API-KEY': process.env.MAILIQO_API_KEY,
'Content-Type': 'application/json',
},
body: JSON.stringify({
from: '[email protected]',
to: '[email protected]',
subject: 'Tu pedido ya ha salido',
body_html: '<p>Tu pedido está en camino.</p>',
body_txt: 'Tu pedido está en camino.',
}),
});
const result = await response.json();
console.log(response.status, result.status);<?php
$payload = [
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Tu pedido ya ha salido',
'body_html' => '<p>Tu pedido está en camino.</p>',
'body_txt' => 'Tu pedido está en camino.',
];
$ch = curl_init('https://api.mailiqo.com/v1/mailing/send');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'X-API-KEY: ' . getenv('MAILIQO_API_KEY'),
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload),
]);
$result = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);// config/services.php: 'mailiqo' => ['key' => env('MAILIQO_API_KEY')],
use Illuminate\Support\Facades\Http;
$response = Http::withHeaders([
'X-API-KEY' => config('services.mailiqo.key'),
])->post('https://api.mailiqo.com/v1/mailing/send', [
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Tu pedido ya ha salido',
'body_html' => '<p>Tu pedido está en camino.</p>',
'body_txt' => 'Tu pedido está en camino.',
]);
$result = $response->json();use Symfony\Component\DependencyInjection\Attribute\Autowire;
use Symfony\Contracts\HttpClient\HttpClientInterface;
final class MailiqoClient
{
public function __construct(
private HttpClientInterface $httpClient,
#[Autowire(env: 'MAILIQO_API_KEY')] private string $apiKey,
) {
}
public function send(array $email): array
{
$response = $this->httpClient->request('POST', 'https://api.mailiqo.com/v1/mailing/send', [
'headers' => ['X-API-KEY' => $this->apiKey],
'json' => $email,
]);
return $response->toArray(false);
}
}import os
import requests
response = requests.post(
'https://api.mailiqo.com/v1/mailing/send',
headers={'X-API-KEY': os.environ['MAILIQO_API_KEY']},
json={
'from': '[email protected]',
'to': '[email protected]',
'subject': 'Tu pedido ya ha salido',
'body_html': '<p>Tu pedido está en camino.</p>',
'body_txt': 'Tu pedido está en camino.',
},
timeout=30,
)
result = response.json()Un 200 significa que el correo se ha encolado: revisa status y, si es warning, la lista rejected_recipients. Ver API de envío de emails.
Errores y límites de envío
API
| HTTP | Qué hacer |
|---|---|
200 | Encolado. Con status = warning, algunos destinatarios se rechazaron: revisa rejected_recipients. |
400 | Corrige la petición: error.code indica el motivo. Ver Errores. |
401 | Revisa la API key. |
429 | Límite de envío alcanzado (código 1421). Espera los segundos de la cabecera Retry-After y vuelve a enviar. |
500 | Vuelve a intentarlo más tarde. |
Una petición rechazada con 429 no se encola: tu aplicación tiene que volver a enviarla cuando pase el tiempo de Retry-After. Ver Límites de envío.
SMTP
Las respuestas que empiezan por 4 son temporales, como 451 4.7.1 al alcanzar el límite de envío: el servidor no ha aceptado el mensaje, así que vuelve a enviarlo más tarde. Las que empiezan por 5 son definitivas: reenviar el mismo mensaje falla hasta que corrijas la causa. Ver Errores SMTP.
Dónde te da cada librería la respuesta del servidor:
| Librería | Dónde |
|---|---|
| Nodemailer | err.responseCode y err.response |
| PHPMailer | $mail->ErrorInfo |
| Laravel y Symfony Mailer | El mensaje de la TransportException |
| Python | smtp_code y smtp_error de smtplib.SMTPResponseException y sus subclases |
Fuentes
Consultadas el 2 de noviembre de 2026 (en inglés):
- Nodemailer — SMTP transport — documentación de Nodemailer
- PHPMailer — repositorio oficial
- Laravel — Mail — documentación de Laravel
- Symfony — Sending emails with Mailer — documentación de Symfony
- smtplib — documentación de Python
Siguientes pasos
- API de envío de emails → /es/api-reference/sending
- Errores SMTP → /es/smtp/errors
