Versiones

La API vive bajo /v1. Los mensajes de webhook llevan "api_version" (hoy 2026-10-01).

Puede cambiar en cualquier momento, sin aviso:

• endpoints nuevos, campos opcionales nuevos en las peticiones, campos nuevos en las respuestas;
• tipos de evento nuevos (los endpoints solo reciben los tipos a los que se suscribieron);
• codes de error nuevos para situaciones nuevas, valores nuevos en campos documentados como listas abiertas (por ejemplo un estado de envío nuevo);
• el orden de los campos en el JSON, el largo de ids y tokens.

Haz que tu integración ignore los campos que no conoce y lea code en los errores.

Nunca cambia dentro de /v1 y de una api_version:

• el significado o el tipo de un campo existente, quitar un campo, volver obligatorio un campo opcional;
• el esquema de firma (Standard Webhooks v1).

Los cambios incompatibles llegan como una versión nueva (/v2, una api_version nueva), anunciada al menos 6 meses antes de que la anterior deje de funcionar, por correo a los dueños de cada empresa con tokens o endpoints activos, y en el registro de cambios.