POST
https://api.getincloud.online/crowsnest/v2/emailsEnviar correo electrónico
Envía un solo correo electrónico a través de la API.
API de Mensajería
Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.
Este endpoint te permite enviar un solo correo electrónico. Se admiten parámetros de consulta.
POST https://api.getincloud.online/crowsnest/v2/emailsParámetros de consulta
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| unsubscribeMsg | string | No | Define el texto de visualización para el enlace de cancelación de suscripción incluido en el cuerpo del correo electrónico, lo que permite a los destinatarios optar por no recibir comunicaciones futuras. Este texto aparecerá como el ancla clicable en la URL de cancelación de suscripción. |
Parámetros del cuerpo
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| to | string | Sí | Dirección de correo electrónico del destinatario. |
| from | string | Sí | Dirección de correo electrónico verificada del remitente. |
| text | string | Sí | Contenido del correo electrónico (puede ser texto plano o HTML). |
| subject | string | Sí | Línea de asunto del correo electrónico. |
| externalId | string | Sí | Identificador alfanumérico utilizado con fines de informes. |
| clientId | string | No | Identificador único del usuario que puede usarse con fines de informes. Es un identificador que puedes usar para identificar de forma única la dirección de destino en tus sistemas. Es similar al externalId y te será devuelto si solicitas callbacks que contengan cambios de estado de los mensajes que envíes. |
| callbacks | array de strings | No | Una o más URLs de webhook (separadas por coma) para notificar sobre el estado de la entrega del mensaje. Tu endpoint debe tener un método de acceso HTTP POST y recibir un cuerpo JSON. La URL es el callback externo donde se registrarán y publicarán los eventos del correo electrónico. Una vez procesado un correo electrónico, su estado se publicará en tu URL de callback. Para ver la lista completa y el significado de cada estado, consulta la sección Estado del Correo Electrónico. |
| alias | string | No | Asigna una etiqueta personalizada o nombre de referencia al destinatario del correo electrónico. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Solicitud de envío de correo electrónico aceptada. |
| 400 | Solicitud incorrecta (Bad Request). |
| 401 | No autorizado (Unauthorized). |
| 404 | Credenciales no encontradas. |
| 410 | Token expirado. |
| 500 | Error interno del servidor. |
¿Te sirvió esta página?