Skip to content

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, puerto 587 con STARTTLS (o 465 con 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_PASS y MAILIQO_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) ​

bash
npm install nodemailer
js
import 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) ​

bash
composer require phpmailer/phpmailer
php
<?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:

ini
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.

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

bash
composer require symfony/mailer

En .env.local:

ini
MAILER_DSN=smtp://USUARIO:[email protected]:587?require_tls=true

Si el usuario o la contraseña tienen caracteres especiales, codifícalos para URL. Para el puerto 465, usa smtps://USUARIO:[email protected]:465.

php
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) ​

python
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.

bash
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."
  }'
js
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
<?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);
php
// 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();
php
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);
    }
}
python
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 ​

HTTPQué hacer
200Encolado. Con status = warning, algunos destinatarios se rechazaron: revisa rejected_recipients.
400Corrige la petición: error.code indica el motivo. Ver Errores.
401Revisa la API key.
429Límite de envío alcanzado (código 1421). Espera los segundos de la cabecera Retry-After y vuelve a enviar.
500Vuelve 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íaDónde
Nodemailererr.responseCode y err.response
PHPMailer$mail->ErrorInfo
Laravel y Symfony MailerEl mensaje de la TransportException
Pythonsmtp_code y smtp_error de smtplib.SMTPResponseException y sus subclases

Fuentes ​

Consultadas el 2 de noviembre de 2026 (en inglés):


Siguientes pasos ​

Built with VitePress