Webhooks

Wire Tagmatic into your ML pipeline. Get notified when annotations complete, items get flagged, or exports are ready.

Subscriptions

Endpoints that receive event payloads

🔗

No webhooks yet. Add one to receive event notifications.

Available Events

Subscribe to one or more events per endpoint

annotation.completed
Fired when a batch annotation job finishes processing all texts
annotation.flagged
Fired when an annotation falls below the confidence threshold (<0.7)
project.export_ready
Fired when a project export is generated and ready for download
file.processing_complete
Fired when a file upload job finishes processing all rows

Payload & Signature

Verify webhook authenticity using HMAC-SHA256

Every delivery includes a X-Tagmatic-Signature header: sha256=<hmac>.
Compute HMAC-SHA256(secret, raw_body) and compare to verify the payload is genuine. 
{
  "event": "annotation.completed",
  "timestamp": "2026-03-17T19:57:22Z",
  "project_id": "123",
  "data": {
    "job_id": 42,
    "summary": { "total": 10, "processed": 10, "failed": 0, "flagged_for_review": 2 },
    "results": [...]
  }
}