Tratamiento de datos
Referencia de 7 endpoints generados desde mosend-wb-backend/src/modules/datos-personales/datos-personales.controller.ts.
/organizations/:orgId/data-consent·7 endpoints·Source: mosend-wb-backend/src/modules/datos-personales/datos-personales.controller.ts/organizations/:orgId/data-consent/policyLa política de tratamiento de datos de la organización, con la vista previa de la pregunta y cuántos contactos hay en cada estado. Si nunca se guardó, una propuesta apagada.
Path params
orgIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/data-consent/policy' \ -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/data-consent/policyCambia la política. Si cambia su contenido (responsable, finalidades, enlace o texto) sube de versión.
Path params
orgIdstringrequerido
Body (JSON)
activabooleanEncendida: a cada contacto nuevo se le pregunta si autoriza el tratamiento de sus datos.
responsablestringResponsable del tratamiento (empresa o persona).
nitstringdireccionstringcanalDeDerechosstringCorreo o teléfono para consultar, corregir o borrar los datos.
finalidadesstringPara qué se usan los datos.
politicaUrlstringEnlace a la política propia. Vacío = la página que arma Mosend.
textoPreguntastringTexto propio de la pregunta.
textoSiAceptastringtextoSiNoAceptastringtextoRevocacionstringesperarRespuestabooleanEl bot espera la respuesta antes de contestar el primer mensaje.
repreguntarEnNuevaVersionbooleanAl cambiar la política, preguntarle otra vez a quienes aceptaron la anterior.
palabrasParaRevocarstring[]Mensajes con los que el contacto revoca.
Respuestas
- 200
curl -X PATCH 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/data-consent/policy' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"activa": true,"responsable": "<responsable>","nit": "<nit>","direccion": "<direccion>","canalDeDerechos": "<canalDeDerechos>","finalidades": "<finalidades>","politicaUrl": "https://tu-app.com/endpoint","textoPregunta": "<textoPregunta>","textoSiAcepta": "<textoSiAcepta>","textoSiNoAcepta": "<textoSiNoAcepta>","textoRevocacion": "<textoRevocacion>","esperarRespuesta": true,"repreguntarEnNuevaVersion": true,"palabrasParaRevocar": []}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/data-consent/contacts/:contactIdEstado de la autorización de un contacto y la prueba de cada evento.
Path params
orgIdstringrequeridocontactIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/data-consent/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/data-consent/contacts/:contactIdRegistra una autorización obtenida por otro medio (formulario, llamada, tienda). Al aceptar, la nota con cómo se obtuvo es obligatoria.
Path params
orgIdstringrequeridocontactIdstringrequerido
Body (JSON)
estadostringrequeridoACEPTADARECHAZADAREVOCADAnotastringCómo se obtuvo (obligatoria al aceptar): «Formulario de la web del 3 de marzo», «Llamada grabada».
canalstringCanal por el que se obtuvo (web, teléfono, tienda…).
evidenciaUrlstringEnlace al soporte (documento firmado, captura).
origenstringasesorapiformulariotienda
Respuestas
- 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/data-consent/contacts/00000000-0000-0000-0000-000000000000' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"estado": "ACEPTADA","nota": "<nota>","canal": "<canal>","evidenciaUrl": "https://tu-app.com/endpoint","origen": "asesor"}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/data-consent/contacts/:contactId/certificateCertificado imprimible (HTML) con la prueba de la autorización del contacto.
Path params
orgIdstringrequeridocontactIdstringrequerido
Respuestas
- 200
curl -X GET 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/data-consent/contacts/00000000-0000-0000-0000-000000000000/certificate' \ -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/data-consent/contacts/:contactId/requestsConsulta, reclamo o pedido de borrar datos del titular: crea una tarea del equipo con el plazo de la ley (10 o 15 días hábiles).
Path params
orgIdstringrequeridocontactIdstringrequerido
Body (JSON)
tipostringrequeridoCONSULTARECLAMOSUPRESIONConsulta: 10 días hábiles. Reclamo y supresión: 15.
detallestringrequeridoQué pidió el titular.
conversationIdstring · uuid
Respuestas
- 201
curl -X POST 'https://api.mosend.dev/organizations/a1b2c3d4-1234-5678-9abc-def012345678/data-consent/contacts/00000000-0000-0000-0000-000000000000/requests' \
-H 'X-Api-Key: mk_live_<prefix>.<secret>' \
-H 'Content-Type: application/json' \
-d '{"tipo": "CONSULTA","detalle": "<detalle>","conversationId": "00000000-0000-0000-0000-000000000000"}'{
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"name": "string",
"description": "string"
},
"timestamp": "2026-05-01T03:42:18.123Z"
}/organizations/:orgId/data-consentLa política de tratamiento de datos publicada por una organización.
Path params
slugstringrequerido
curl -X GET 'https://api.mosend.dev/organizations/:orgId/data-consent' \ -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"
}