Webhooks

Configure webhooks to receive real-time event notifications from Maecos in your external systems.

Maecos can send real-time HTTP notifications to external endpoints when key events occur in the platform. Webhooks enable you to react to operational changes without polling the API.

Supported events

Webhooks can be configured for events across all major modules:

Module	Example events
Issues	Issue created, status changed, assigned, closed
Actions	Action created, completed, overdue
Checklists	Checklist completed, check failed compliance
Training	Course completed, qualification expiring
Documents	Document approved, new version published

The full list of available webhook events depends on your Maecos configuration. Contact your administrator for the current event catalog.

Payload format

Webhook payloads are sent as JSON over HTTPS POST requests. Each payload includes:

• event_type — the event identifier (e.g., issue.created)

• timestamp — UTC timestamp of the event

• data — the event-specific payload containing relevant entity data

• tenant_id — your Maecos tenant identifier

Configuration

Webhook endpoints are configured by your Maecos administrator. Each webhook subscription requires:

• A target HTTPS URL

• The events to subscribe to

• Optional: authentication headers or shared secrets for payload verification

Security

• Webhooks are sent over HTTPS only

• Payloads can include a signature header for verification

• Failed deliveries are retried with exponential backoff

• Webhook delivery logs are available for troubleshooting

For webhook setup or custom event requirements, contact [email protected].