Contactos bloqueados
Referencia de 7 endpoints generados desde mosend-wb-backend/src/modules/bloqueos/bloqueos.controller.ts.
/organizations/:orgId/blocked-contacts·7 endpoints·Source: mosend-wb-backend/src/modules/bloqueos/bloqueos.controller.ts/organizations/:orgId/blocked-contactsContactos 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
pagenumberpageSizenumber
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>'
{
"data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
}
],
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/blocked-contacts/bulkBloquea varios contactos a la vez (hasta 500).
Path params
orgIdstringrequerido
Body (JSON)
contactIdsstring[]requeridomotivostringrequeridoSPAMACOSOFRAUDEOTROnotastringenWhatsAppboolean
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}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/blocked-contacts/sync-whatsappTrae 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>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/blocked-contacts/:contactIdEstado del bloqueo de un contacto.
Path params
orgIdstringrequeridocontactIdstringrequerido
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>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/blocked-contacts/:contactIdBloquea 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
orgIdstringrequeridocontactIdstringrequerido
Body (JSON)
motivostringrequeridoSPAMACOSOFRAUDEOTROnotastringDetalle para el equipo (no lo ve el contacto).
enWhatsAppbooleanAdemá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.
cerrarConversacionesbooleanCerrar 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}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/blocked-contacts/:contactIdDesbloquea un contacto. Si estaba bloqueado en WhatsApp y Meta no lo permite ahora, queda pendiente y se reintenta.
Path params
orgIdstringrequeridocontactIdstringrequerido
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>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/blocked-contacts/:contactId/messagesLo que escribió estando bloqueado (guardado aparte, sin bandeja).
Path params
orgIdstringrequeridocontactIdstringrequerido
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>'
{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"createdAt": "2026-05-01T03:42:18.123Z"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}