Contactos bloqueados

Referencia de 7 endpoints generados desde mosend-wb-backend/src/modules/bloqueos/bloqueos.controller.ts.

Base path: /organizations/:orgId/blocked-contacts·7 endpoints·Source: mosend-wb-backend/src/modules/bloqueos/bloqueos.controller.ts
GET/organizations/:orgId/blocked-contacts
bearer

Contactos bloqueados de la organización, con motivo, quién los bloqueó, el estado en WhatsApp y cuántos mensajes suyos se guardaron ocultos.

Path params

  • orgIdstringrequerido

Query params

  • pagenumber
  • pageSizenumber

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/blocked-contacts' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2026-05-01T03:42:18.123Z"
    }
  ],
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/blocked-contacts/bulk
bearer

Bloquea varios contactos a la vez (hasta 500).

Path params

  • orgIdstringrequerido

Body (JSON)

  • contactIdsstring[]requerido
  • motivostringrequerido
    SPAMACOSOFRAUDEOTRO
  • notastring
  • enWhatsAppboolean

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/blocked-contacts/bulk' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"contactIds": [],"motivo": "SPAM","nota": "<nota>","enWhatsApp": true}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/blocked-contacts/sync-whatsapp
bearer

Trae de WhatsApp la lista de bloqueados de cada número: los bloqueados desde la app del teléfono quedan también bloqueados en Mosend.

Path params

  • orgIdstringrequerido

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/blocked-contacts/sync-whatsapp' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/blocked-contacts/:contactId
bearer

Estado del bloqueo de un contacto.

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/blocked-contacts/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
POST/organizations/:orgId/blocked-contacts/:contactId
bearer

Bloquea un contacto: no puede escribirle a la organización (lo que escriba se guarda aparte) y nadie le puede escribir. Opcionalmente, también en WhatsApp.

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Body (JSON)

  • motivostringrequerido
    SPAMACOSOFRAUDEOTRO
  • notastring

    Detalle para el equipo (no lo ve el contacto).

  • enWhatsAppboolean

    Además de Mosend, bloquearlo en WhatsApp (Meta). Meta solo lo permite si escribió en las últimas 24 h; si no, queda pendiente y se aplica cuando vuelva a escribir. Puede no poder deshacerse después.

  • cerrarConversacionesboolean

    Cerrar sus conversaciones abiertas (por defecto sí).

Respuestas

  • 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/blocked-contacts/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>' \
  -H 'Content-Type: application/json' \
  -d '{"motivo": "SPAM","nota": "<nota>","enWhatsApp": true,"cerrarConversaciones": true}'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "name": "string",
    "description": "string"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
DELETE/organizations/:orgId/blocked-contacts/:contactId
bearer

Desbloquea un contacto. Si estaba bloqueado en WhatsApp y Meta no lo permite ahora, queda pendiente y se reintenta.

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Respuestas

  • 200
curl -X DELETE 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/blocked-contacts/00000000-0000-0000-0000-000000000000' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}
GET/organizations/:orgId/blocked-contacts/:contactId/messages
bearer

Lo que escribió estando bloqueado (guardado aparte, sin bandeja).

Path params

  • orgIdstringrequerido
  • contactIdstringrequerido

Respuestas

  • 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/blocked-contacts/00000000-0000-0000-0000-000000000000/messages' \
  -H 'X-Api-Key: mk_live_<prefix>.<secret>'
Response · 200
{
  "data": {
    "id": "00000000-0000-0000-0000-000000000000",
    "createdAt": "2026-05-01T03:42:18.123Z"
  },
  "timestamp": "2026-05-01T03:42:18.123Z"
}