URL base y convenciones
Toda la API REST de Mosend vive bajo un único origen y comparte un formato de respuesta uniforme.
URL base
https://api.mosend.dev
No hay versionado en el path: nuevos campos se agregan de forma backwards-compatible y los cambios disruptivos se anuncian en la página de cambios recientes.
Formato de respuesta
Las respuestas exitosas se envuelven en un objeto con data y timestamp:
{
"data": { /* recurso o lista */ },
"timestamp": "2026-05-01T03:42:18.123Z"
}Los errores se documentan en Errores.
Convenciones
- El multi-tenancy se expresa como prefijo
/organizations/{orgId}/...en la mayoría de las rutas. El usuario o API key sólo accede a las organizaciones a las que pertenece. - Los 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 zona de la org.
- Paginación basada en
cursoropaco (no offsets numéricos) para rutas que listan muchos items. - Rate limiting global. Las webhooks entrantes desde Meta tienen
@SkipThrottle.