Verificar tu dominio de envío
El dominio propio con el que un workspace manda campañas de correo.
POST /sending-domains crea la identidad de envío del workspace en el proveedor de correo. No hay un dominio compartido de respaldo: para mandar campañas necesitas el tuyo. La respuesta trae los registros DNS que hay que publicar en tu registrador, los CNAME de DKIM y el par MX/TXT de MAIL FROM.
Este recurso es infraestructura de canal y cuesta el mismo scope que conectar un canal. Leer pide messaging_accounts:read; escribir, messaging_accounts:write.
Crear un dominio
curl -X POST https://api.vitrinadev.com/api/v1/sending-domains \
-H "Authorization: Bearer $VITRINA_KEY" \
-H "Content-Type: application/json" \
-d '{ "domain": "mail.autosdelvalle.cl" }'{
"data": {
"id": "d9d9d9d9-0000-4000-8000-000000000001",
"domain": "mail.autosdelvalle.cl",
"dkim_status": "pending",
"mail_from_domain": "bounce.mail.autosdelvalle.cl",
"mail_from_status": "pending",
"verified_for_sending": false,
"tracking_domain": "click.mail.autosdelvalle.cl",
"tracking_ready": false,
"records": [
{ "type": "CNAME", "name": "ab12cd34ef56gh78._domainkey.mail.autosdelvalle.cl", "value": "ab12cd34ef56gh78.dkim.amazonses.com" },
{ "type": "MX", "name": "bounce.mail.autosdelvalle.cl", "value": "10 feedback-smtp.us-east-1.amazonses.com" },
{ "type": "TXT", "name": "bounce.mail.autosdelvalle.cl", "value": "v=spf1 include:amazonses.com ~all" }
]
}
}Todo campo de estado arranca en pending. records solo viene en la respuesta de creación, y es la lista que hay que copiar al registrador del dominio.
Verificar
Una vez publicados los registros DNS, y después de que se propaguen (puede tardar horas):
curl -X POST https://api.vitrinadev.com/api/v1/sending-domains/d9d9d9d9-0000-4000-8000-000000000001/verify \
-H "Authorization: Bearer $VITRINA_KEY"{
"data": {
"id": "d9d9d9d9-0000-4000-8000-000000000001",
"domain": "mail.autosdelvalle.cl",
"dkim_status": "verified",
"mail_from_status": "verified",
"verified_for_sending": true,
"tracking_ready": true,
"last_checked_at": "2026-09-15T18:20:00.000Z"
}
}No hay webhook para esto. El proveedor no avisa cuando terminan de propagar los registros, así que verify es sondeo bajo demanda. Llámalo tantas veces como haga falta mientras el DNS se propaga.
Cuota de envío
curl https://api.vitrinadev.com/api/v1/sending-domains/quota \
-H "Authorization: Bearer $VITRINA_KEY"{
"data": {
"max_24_hour_send": 50000,
"sent_last_24_hours": 812,
"max_send_rate": 14,
"production_access_enabled": true
}
}Es la cuota que el proveedor de correo le da al workspace completo y no se reparte por dominio. Sirve para saber cuánto margen queda antes de una campaña grande.
El contrato campo por campo está en la referencia de Dominios de envío.