Documentação da API Mokapen

Visão geral

Registre uma URL de webhook e selecione os eventos que quer receber. Quando um evento acontece, o Mokapen envia uma requisição HTTP POST para o seu endpoint com payload JSON.

Os endpoints de gestão de webhook exigem um Bearer token válido com os scopes adequados.

Endpoints da 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 um webhook

Envie um POST com URL de callback, organization ID e eventos selecionados:

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

Segurança

Valide as requisições de webhook que chegam no seu servidor. Use só endpoints HTTPS. Guarde os secrets com segurança e valide os payloads antes de processá-los.

Eventos de webhook suportados

Ao registrar um webhook você pode assinar um ou mais destes eventos: