maintainx-webhooks-events

# MaintainX Webhooks & Events ## Overview Build real-time integrations with MaintainX using webhooks for work order updates, asset changes, and maintenance notifications. MaintainX fires webhook events when key resources change. ## Prerequisites - MaintainX account with API access - HTTPS endpoint accessible from the internet (ngrok for local dev) - `MAINTAINX_API_KEY` environment variable configured ## Instructions ### Step 1: Register a Webhook ```bash curl -X POST https://api.getmaintainx.com/v1/webhooks \ -H "Authorization: Bearer $MAINTAINX_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://your-app.example.com/webhooks/maintainx", "events": [ "workorder.created", "workorder.updated", "workorder.status_changed", "workorder.completed" ] }' ``` ### Step 2: Webhook Receiver (Express) ```typescript // src/webhook-server.ts import express from 'express'; import crypto from 'node:crypto'; const app = express(); app.use(express.json({ limit: '1mb' })); // Signature verification middleware function verifySignature(secret: string) { return (req: express.Request, res: express.Response, next: express.NextFunction) => { const signature = req.headers['x-maintainx-signature'] as string; if (!signature) { return res.status(401).json({ error: 'Missing signature header' }); } const expected = crypto .createHmac('sha256', secret) .update(JSON.stringify(req.body)) .digest('he...