Drometra
Solicitar acceso

Avisos por correo

Quién recibe los avisos y resúmenes por correo, y qué se envió.

Ver la configuración de correos

GEThttps://api.drometra.com/v1/notifications/email/settings

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

  • deliveryReceiptsbooleansiempre
  • webhookAlertsbooleansiempre
  • weeklyReportbooleansiempre
  • afterHoursAlertbooleansiempre
  • versionintegersiempre
  • emailDeliveryenum: enabled | disabledsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/notifications/email/settings" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"
respuesta · 200
{
  "deliveryReceipts": true,
  "webhookAlerts": true,
  "weeklyReport": true,
  "afterHoursAlert": true,
  "version": 0,
  "emailDelivery": "enabled"
}

Guardar la configuración de correos

PUThttps://api.drometra.com/v1/notifications/email/settings

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

deliveryReceiptsobligatorioboolean
webhookAlertsobligatorioboolean
weeklyReportboolean
afterHoursAlertboolean
versionobligatoriointeger

Respuesta · 200

  • deliveryReceiptsbooleansiempre
  • webhookAlertsbooleansiempre
  • weeklyReportbooleansiempre
  • afterHoursAlertbooleansiempre
  • versionintegersiempre
  • emailDeliveryenum: enabled | disabledsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X PUT "https://api.drometra.com/v1/notifications/email/settings" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryReceipts": true,
    "webhookAlerts": true,
    "version": 0
  }'
respuesta · 200
{
  "deliveryReceipts": true,
  "webhookAlerts": true,
  "weeklyReport": true,
  "afterHoursAlert": true,
  "version": 0,
  "emailDelivery": "enabled"
}

Listar destinatarios de correo

GEThttps://api.drometra.com/v1/notifications/email/recipients

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Respuesta · 200

  • array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/notifications/email/recipients" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"
respuesta · 200
{
  "items": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "address": "…",
      "state": "pending",
      "verifiedAt": "2026-10-21T14:02:31Z",
      "version": 1
    }
  ]
}

Agregar un destinatario de correo

POSThttps://api.drometra.com/v1/notifications/email/recipients

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.
idempotency-keyobligatoriostring · uuid
Un UUID nuevo por operación. Si repites la petición con la misma clave, el cambio no se aplica dos veces.

Cuerpo

addressobligatoriostring

Respuesta · 201

  • idstring · uuidsiempre
  • addressstringsiempre
  • stateenum: pending | verified | removedsiempre
  • verifiedAtstring · null · date-timesiempre
  • versionintegersiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/notifications/email/recipients" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "idempotency-key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "…"
  }'
respuesta · 201
{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "address": "…",
  "state": "pending",
  "verifiedAt": "2026-10-21T14:02:31Z",
  "version": 1
}

Verificar un destinatario

POSThttps://api.drometra.com/v1/notifications/email/recipients/{id}/verify

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid
ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

codeobligatoriostring

Respuesta · 200

  • idstring · uuidsiempre
  • addressstringsiempre
  • stateenum: pending | verified | removedsiempre
  • verifiedAtstring · null · date-timesiempre
  • versionintegersiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/notifications/email/recipients/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/verify" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "…"
  }'
respuesta · 200
{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "address": "…",
  "state": "pending",
  "verifiedAt": "2026-10-21T14:02:31Z",
  "version": 1
}

Reenviar la verificación

POSThttps://api.drometra.com/v1/notifications/email/recipients/{id}/resend

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid
ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Respuesta · 202

  • idstring · uuidsiempre
  • addressstringsiempre
  • stateenum: pending | verified | removedsiempre
  • verifiedAtstring · null · date-timesiempre
  • versionintegersiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/notifications/email/recipients/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/resend" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{}'
respuesta · 202
{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "address": "…",
  "state": "pending",
  "verifiedAt": "2026-10-21T14:02:31Z",
  "version": 1
}

Quitar un destinatario

POSThttps://api.drometra.com/v1/notifications/email/recipients/{id}/remove

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid
ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Cuerpo

versionobligatoriointeger

Respuesta · 200

  • idstring · uuidsiempre
  • addressstringsiempre
  • stateenum: pending | verified | removedsiempre
  • verifiedAtstring · null · date-timesiempre
  • versionintegersiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/notifications/email/recipients/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/remove" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "version": 0
  }'
respuesta · 200
{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "address": "…",
  "state": "pending",
  "verifiedAt": "2026-10-21T14:02:31Z",
  "version": 1
}

Listar correos bloqueados

GEThttps://api.drometra.com/v1/notifications/email/suppressions

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de consulta

limitinteger

Respuesta · 200

  • array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/notifications/email/suppressions" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"
respuesta · 200
{
  "items": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "reason": "hard_bounce",
      "createdAt": "2026-10-21T14:02:31Z"
    }
  ]
}

Bloquear un correo

POSThttps://api.drometra.com/v1/notifications/email/suppressions

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Cuerpo

addressobligatoriostring

Respuesta · 201

  • idstring · uuidsiempre
  • reasonenum: hard_bounce | recipient_request | adminsiempre
  • createdAtstring · date-timesiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/notifications/email/suppressions" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{
    "address": "…"
  }'
respuesta · 201
{
  "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
  "reason": "hard_bounce",
  "createdAt": "2026-10-21T14:02:31Z"
}

Desbloquear un correo

POSThttps://api.drometra.com/v1/notifications/email/suppressions/{id}/remove

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de ruta

idobligatoriostring · uuid
ej. 0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X POST "https://api.drometra.com/v1/notifications/email/suppressions/0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d/remove" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Content-Type: application/json" \
  -d '{}'
respuesta · 204
(sin cuerpo)

Listar correos enviados

GEThttps://api.drometra.com/v1/notifications/email/messages

Pide el token de acceso de una persona de tu empresa.

Cabeceras

x-tenant-idobligatoriostring · uuid
El identificador de tu empresa. El servidor comprueba que sigas siendo miembro activo de ella.

Parámetros de consulta

limitinteger

Respuesta · 200

  • array de objectsiempre

Puede responder con error 400, 401, 403, 404, 409, 410, 413, 415, 422, 429, 503. El cuerpo de error se explica en Conceptos.

petición
curl -X GET "https://api.drometra.com/v1/notifications/email/messages" \
  -H "Authorization: Bearer $DROMETRA_TOKEN" \
  -H "x-tenant-id: $DROMETRA_TENANT" \
  -H "Accept: application/json"
respuesta · 200
{
  "items": [
    {
      "id": "0b6f8c2e-4a1d-4e5b-9c3f-2d7e8a9b1c4d",
      "kind": "recipient_verification",
      "state": "queued",
      "attempts": 0,
      "lastError": "…",
      "createdAt": "2026-10-21T14:02:31Z",
      "sentAt": "2026-10-21T14:02:31Z"
    }
  ]
}