Documentación de la API Mokapen

Resumen

Registra una URL de webhook y selecciona los eventos que quieres recibir. Cuando ocurre un evento, Mokapen envía una solicitud HTTP POST a tu endpoint con payload JSON.

Los endpoints de gestión de webhook requieren un Bearer token válido con los scopes adecuados.

Endpoints de la API de webhook

GET    /api/webhooks
POST   /api/webhooks
PUT    /api/webhooks/{webhook_id}
DELETE /api/webhooks/{webhook_id}
GET    /api/webhooks/{webhook_id}/logs
GET    /api/webhook-events

Registrar un webhook

Envía un POST con URL de callback, organization ID y eventos seleccionados:

POST /api/webhooks
Authorization: Bearer YOUR_ACCESS_TOKEN
Content-Type: application/json

{
  "url": "https://example.com/webhooks/mokapen",
  "org_id": 849,
  "events": ["task.created", "task.updated", "contact.created"]
}

Seguridad

Verifica las solicitudes de webhook que llegan a tu servidor. Usa solo endpoints HTTPS. Guarda los secrets de forma segura y valida los payloads antes de procesarlos.

Eventos de webhook soportados

Al registrar un webhook puedes suscribirte a uno o más de estos eventos: