Send your first email
Authenticate with a server-side API key and submit a JSON payload. A successful response means VuelaMail accepted the message into its durable delivery queue.
Keep API keys on your server. Never expose credentials in browser JavaScript or a public repository.
Authentication
Pass your key as a Bearer token in the Authorization header.
HEADER Authorization: Bearer vm_live_••••••••
Send email
POST https://api.vuelamail.com/v1/email
curl https://api.vuelamail.com/v1/email \
-H "Authorization: Bearer $VUELA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": "hello@yourdomain.com",
"to": ["customer@example.com"],
"subject": "Your order is on its way",
"html": "<h1>Good news.</h1>"
}'The response returns a stable message identifier that can be matched with webhook events.
{
"accepted": true,
"message_id": "msg_01J8Y6V8M2...",
"status": "queued"
}Webhooks
Subscribe to delivered, deferred, bounce, complaint and unsubscribe events. Verify the signature before applying an event to your system.
EVENT message.delivered · message.bounced · recipient.unsubscribed
SMTP relay
Applications that already support SMTP can connect without an API integration.
host smtp.vuelamail.com
port 587
security STARTTLS
username your SMTP credential
password your SMTP token