Mosend Developer

Documentación de la API REST de Mosend

Esta referencia describe los 128 endpoints reales (36 módulos) que expone el backend de Mosend en producción. Se genera automáticamente desde los controllers del repositorio — nada inventado, nada desincronizado.

Autenticación

Bearer JWT y API Keys. Cómo obtener un token y qué scopes tiene.

Errores

Formato uniforme de errores y códigos comunes.

Endpoints

128 rutas organizadas por módulo. Path completo, params y ejemplos curl.

Webhooks salientes

Eventos que Mosend dispara hacia tu backend. Firma HMAC SHA-256.

URL base

https://api.mosend.dev

Todas las respuestas se envuelven en { "data": ..., "timestamp": "..." }.

Convenciones

El multi-tenancy se expresa como prefijo /organizations/{orgId}/... en la mayoría de rutas. El usuario solo puede acceder a las orgs en las que es miembro.
IDs son UUID v4 salvo que se indique lo contrario. Los metaXxxId (números, WABA, mensaje) son strings opacos de Meta.
Fechas en formato ISO 8601 UTC. El dashboard las formatea según la timezone de la organización.
Paginación basada en cursor opaco (no offsets numéricos) para rutas que listan muchos items.
Rate limiting global. Webhooks entrantes tienen @SkipThrottle.

Nota: los DTOs y tipos exactos se documentan a partir de su nombre tal como aparece en el código. Para el shape completo de cada DTO consulta el repositorio del backend (privado).