Documentazione API Mokapen

Panoramica

Registra un URL webhook e seleziona gli eventi da ricevere. Quando si verifica un evento, Mokapen invia una richiesta HTTP POST al tuo endpoint con payload JSON.

Gli endpoint di gestione webhook richiedono un Bearer token valido con gli scope appropriati.

Endpoint API 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

Registrare un webhook

Invia una POST con URL di callback, organization ID ed eventi selezionati:

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"]
}

Sicurezza

Verifica le richieste webhook in ingresso sul tuo server. Usa solo endpoint HTTPS. Conserva i secret in modo sicuro e valida i payload prima di processarli.

Eventi webhook supportati

Registrando un webhook puoi sottoscrivere uno o più dei seguenti eventi: