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 cursor opaco (no offsets numéricos) para rutas que listan muchos items.
  • Rate limiting global. Las webhooks entrantes desde Meta tienen @SkipThrottle.